TdiCopyMdlToBuffer

NTSTATUS
   TdiCopyMdlToBuffer (
       IN PMDL SourceMdlChain,
       IN ULONG SourceOffset,
       IN PVOID DestinationBuffer,
       IN ULONG DestinationOffset,
       IN ULONG DestinationBufferSize,
       OUT PULONG BytesCopied
      );

TdiCopyMdlToBuffer 함수는 주어진 MDL에 의해서 맵된 버퍼의 모음으로부터 호출자 제공 목적지 버퍼의 범위로 데이타를 복사한다.

매개변수

SourceMdlChain

복사되는 데이타를 포함하는 버퍼를 매핑하는 MDL 체인의 처음 MDL을 가리킨다.

SourceOffset

복사를 시작하는 맵된 소스 버퍼안에 바이트 옵셋을 서술한다. 효과적으로 이것은 복사를 시작하기 전에 건너뛰는 맵된 소스 바이트의 수이다.

DestinationBuffer

호출자 제공 목적지 버퍼를 가리킨다.

DestinationOffset

소스 버퍼로부터 데이타를 복사하기 시작하는 목적지 버퍼안에 바이트 옵셋을 서술한다.

DestinationBufferSize

DestinationBuffer에 버퍼의 바이트 사이즈를 서술한다.

BytesCopied

TdiCopyMdlToBuffer 함수가 복사한 바이트의 수를 리턴하는 호출자 제공 변수를 가리킨다.

리턴값

TdiCopyMdlToBuffer 함수는 목적지 버퍼 안으로 (DestinationBufferSize - DestinationOffset) 바이트를 복사한다면 STATUS_SUCCESS를 리턴한다. 반면에 SourceOffset에서 시작하는 주어진 SourceMdlChain이 (DestinationBufferSize - DestinationOffset)가 포함할 수 있는 범위 이상으로 맵한다면 STATUS_BUFFER_OVERFLOW를 리턴하다.

주석

TdiCopyMdlToBuffer 함수는 STATUS_BUFFER_OVERFLOW를 리턴하다고 할지라도 맵된 소스 버퍼에서 주어진 목적지 버퍼 범위안으로 가능한 한 많은 데이타를 복사한다.

대부분 DestinationOffset이 0 이라면 BytesCopied의 리턴값은 주어진 DestinationBufferSize일 수 있다.

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

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