NdisCopyBuffer

VOID

  NdisCopyBuffer(

    OUT PNDIS_STATUS  Status,

    OUT PNDIS_BUFFER  *Buffer,

    IN NDIS_HANDLE  PoolHandle,

    IN PVOID  MemoryDescriptor,

    IN UINT  Offset,

    IN UINT  Length

    );

NdisCopyBuffer함수는 지정된 가상(하위)범위에대한 버퍼 디스크립터, 블럭에대한 메모리 디스크립터에대한 포인터와 이미 할당된 블럭에대한 주어진 핸들을 생성한다.

매개변수

Status
이 함수가 버퍼 디스크립터 카피 연산의 마지막 상태를 리턴하는 호출자 할당 포인터. 다음중 하나일수 있다.:

NDIS_STATUS_SUCCESS
드라이버는 버퍼디스크립터혹은 버퍼디스크립터 체인을 사용할수 있다.

NDIS_STATUS_FAILURE
주어진 범위를 맵하는데 실패했다. 옵셋과 길이 지정이 정확하지 않기 때문일수 있다.

Buffer
이 함수가 호출이 성공이라면 새로운 버퍼에대한 포인터를 리턴하는 것에서의 호출자 할당 버퍼를 지정한다.

PoolHandle
NdisAllocateBufferPool함수의 이전의 호출에의해 리턴된 핸들을 지정한다.

MemoryDescriptor
NDIS_BUFFER일수 있는 메모리 디스크립터의 포인터.

Offset
카피를 시작하는 메모리 블럭내의 바이트 옵셋을 지정한다.

Length
카피하기위한 바이트수를 지정한다.

주석

NdisCopyBuffer함수는 주어진 메모리 디스크립터에의해 설명된 메모리 블럭내의 (서브)범위를 맵핑하는 버퍼 디스크립터를 생성한다. 이 함수는 새롱누 버퍼 디스크립터에대한 공간을 할당한다. 그리고 주어진 MemoryDescriptor로부터 새로운 버퍼 디스크립터로 복사한다.

만약 주어진 메모리 디스크립터가 체인된 요소들을 포함한다면, NdisCopyBuffer함수가 생성하는 버퍼 디스크립터는 버퍼디스크립턷르의 체인의 헤드일수 있다. 드라이버는 NdisGetNextBuffer함수를 호출할 수 있다. 그리고 각 체인된 버퍼 디스크립터를 쿼리하기위해 NdisQueryBufferSafe함수 혹은 NdisQueryBuffer함수를 호출할수 있다.

드라이버는 NdisCopyBuffer함수의 호출전에 가지고 있는 어떤 스핀 락을 해제한다. 드라이버는 버퍼 디스크립터가 더이상 필요 없을때 버퍼 디스크립터를 해제하기위해 NdisFreeBuffer를 호출해야만 한다.

NdisCopyBuffer함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작될 수 있다.