NdisAllocateBuffer

VOID NdisAllocateBuffer( OUT PNDIS_STATUS Status, OUT PNDIS_BUFFER *Buffer, IN NDIS_HANDLE PoolHandle, IN PVOID VirtualAddress, IN UINT Length );

NdisAllocateBuffer은 이미 할당된, 비 페이지화된 메모리 블럭내에 특정 가상 범위(range, 영역)와 맵핑하는 버퍼 디스크립터를 만든다.

매개변수

Status

이 함수는 버퍼 할당의 마지막 상태를 리턴하는 호출자 제공 변수를 가리킨다. 만약 Buffer에 유효한 버퍼 디스크립터 포인터를 리턴한다면은 NDIS_STATUS_SUCCESS가 될 것이고 그렇지 않는다면은 NDIS_STATUS_FAILURE가 될 것이다.

Buffer

이 함수가 할당된 버퍼 디스크립터에 대한 포인터를 리턴하는 호출자 제공 변수를 가리킨다.

PoolHandle

NdisAllocateBufferPool에 대한 선행(preceding) 호출에 의해 리턴된 핸들을 지정한다.

VirtualAddress

리턴된 버퍼 디스크립터내에 맵핑된 전에 할당된 시스템 공간 메모리의 기본 가상 주소(base virtual address)를 가리킨다.

Length

맵될 바이트 수를 지정한다.

주석

NdisAllocateBuffer은 패킷 헤더 혹은 NIC 리시브 버퍼를 위해 사용된 메모리와 같은 전에 할당된 메모리의 특정 영역(범위, range)을 맵하기 위해 버퍼 디스크립터를 초기화하고 그리고 저장 공간을 할당한다.

버퍼 디스크립터 할당은 NdisAllocateBufferPool로 만든 버퍼 풀(pool)에 드로우한다.(draws) 드라이버는 만약 초기화하는 동안 NdisAllocateBufferPool이 호출되어진다면은 필요한 만큼 버퍼 디스크립터들을 할당하기 위해 필요한 만큼 여러번 NdisAllocateBuffer를 호출할 수 있다.

모든 하위 레벨 NDIS 드라이버들은 버퍼 풀(pool)로부터 패킷들을 연결한 모든 버퍼 디스크립터들을 할당해야 한다. 단지 가장 상위 레벨 프로토콜 드라이버들은 가상 메모리 영역들에(ranges)에 맵핑된 OS 종속 디스크립터들에 제공되어질 수 있다. 만약 이러한 메모리 디스크립터들이 NDIS 버퍼 디스크립터들과 동등하다면은(equivalent), 가장 상위 레벨 프로토콜은 그러한 디스크립터들을 매개변수로서 NdisXxx 함수들에 전달할 수 있다.

NdisAllocateBuffer의 호출자는 IRQL <= DISPATCH_LEVEL로 실행한다.