TdiCopyBufferToMdl

NTSTATUS
   TdiCopyBufferToMdl (
       IN PVOID SourceBuffer,
       IN ULONG SourceOffset,
       IN ULONG SourceBytesToCopy,
       IN PMDL DestinationMdlChain,
       IN ULONG DestinationOffset,
       IN PULONG BytesCopied
      );

TdiCopyBufferToMdl 함수는 버퍼 범위에 있는 데이타를 주어진 MDL 체인에 의해서 맵된 하나이상의 목적지 버퍼안으로 복사한다.

매개변수

SourceBuffer

복사되는 데이타를 포함하는 소스 버퍼의 기본 가상 주소를 서술한다.

SourceOffset

복사를 시작하는 소스 버퍼안에 바이트 옵셋을 서술한다.

SourceBytesToCopy

주어진 MDL에 의해서 맵된 버퍼에 SourceBuffer로부터 복사되는 바이트 수를 서술한다.

DestinationMdlChain

데이타가 복사될 목적지 버퍼를 맵하는 연결된 체인의 MDL안에 처음 MDL을 가리킨다.

DestinationOffset

복사가 시작되는 목적지 버퍼안에 바이트 옵셋을 서술한다. 효과적으로 이것은 복사연산을 시작하기 전에 건너뛰는 주어진 MDL에 의해서 맵된 바이트의 수이다.

BytesCopied

TdiCopyBufferToMdl 함수가 소스에서 목적지 버퍼로 복사된 바이트 수를 리턴하는 호출자 제공 변수를 가리킨다.

리턴값

TdiCopyBufferToMdl 함수가 맵된 목적지 버퍼로 SourceBytesToCopy를 복사했다면 STATUS_SUCCESS를 리턴한다. 반면에 SourceBytesToCopy가 너무 커서 주어진 DestinationOffset에서 이용할 수 있는 목적지 버퍼안으로 복사할 수 없다면 STATUS_BUFFER_OVERFLOW를 리턴한다.

주석

TdiCopyBufferToMdl 함수는 STATUS_BUFFER_OVERFLOW를 리턴한다 할지라도 소스 버퍼에서 목적지 버퍼로 가능한 한 많은 버퍼를 복사할 수 있다. 대부분 BytesCopied의 리턴값은 주어진 SourceBytesToCopy와 같다.

트랜스포트와 그들의 커널 모드 클라이언트 모두 TdiCopyBufferToMdl 함수를 호출할 수 있다.

소스와 목적지 버퍼가 존재한다면 TdiCopyBufferToMdl 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다. 그중 하나가 페이저블이라면 호출자는 IRQL < DISPATCH_LEVEL에서 실행한다.