NdisAllocateBufferPool

VOID NdisAllocateBufferPool( OUT PNDIS_STATUS Status, OUT PNDIS_HANDLE PoolHandle, IN UINT NumberOfDescriptors );

NdisAllocateBufferPool은 호출자가 NdisAllocateBuffer를 호출함으로써 버퍼 디스크립터들을 할당할 수 있는 핸들을 리턴한다.

매개변수

Status

이 함수는 항상 NDIS_STATUS_SUCCESS인 버퍼 풀(pool) 할당에 대한 마지막 상태를 리턴하는 호출자 제공 변수를 가리킨다.

PoolHandle

이 함수는 버퍼 풀(pool)에 대한 핸들을 리턴하는 호출자 제공 변수를 가리킨다. 이 핸들은 드라이버 계속해서 호출하는 Ndis...Buffer에 대한 제공된 매개변수이다.

NumberOfDescriptors

어떤 할당된 버퍼 디스크립터가 풀(pool)로 되돌려 해제하는 것 없이 버퍼 풀(pool)로부터 호출자가 할당을 기대하는 버퍼 디스크립터들의 수를 지정한다.

주석

NdisAllocateBufferPool를 리턴한 후, 드라이버는 요구한 버퍼 디스크립터들을 하나나 그 이상 할당하기 위해 NdisAllocateBuffer를 호출한다.

NIC 드라이버에 의해 지정된 NumberOfDescriptors는 NIC의 특징들에 의존한다. 예를 들어, 링 버퍼들을 가지는 버스마스터 DMA NIC의 드라이버는 적어도 풀(full) 링을 맵하기 위해 매우 충분한 NumberOfDescriptors를 지정해야 한다.

NdisAllocateBufferPool에 대한 호출로 지정된 NumberOfDescriptors은 NdisFreeBuffer를 호출해서 버퍼 풀(pool)를 위해 프리 리스트(free list)로 버퍼 디스크립터들을 리턴하기 전에 NdisAllocateBuffer를 몇번 호출할 수 있는 지를 결정하는 효율적인 제한이다.

드라이버가 더 이상 할당 된 버퍼 풀(pool)이 필요하지 않는다면, NdisFreeBufferPool를 호출해서 버퍼 풀(pool) 핸들을 해제한다.

드라이버는 NdisAllocateBufferPool를 호출하기 전에 유지한 어떤 스핀 락을 해제해야 한다.

모든 낮은 레벨 NDIS 드라이버들은 그들이 버퍼 풀(pool)로부터 패킷들을 연결하는 모든 버퍼 디스크립터들을 할당해야 한다. 단지 높은 레벨 프로토콜 드라이버들은 가상 메모리 범위들을 맵핑하는 OS-의존 디스크립터들이 제공될 수 있다. 만약 이러한 메모리 디스크립터들이 NDIS 버퍼 디스크립터들과 동등하면은(equivalent) 높은 레벨 프로토콜은 그러한 디스크립터들을 NdisXxx 함수들에게 매개변수로 전달할 수 있다.

NdisAllocateBufferPool에 대한 호출자는 IRQL <= DISPATCH_LEVEL로 실행된다.