NdisGetBufferPhysicalArraySize

VOID NdisGetBufferPhysicalArraySize( IN PNDIS_BUFFER Buffer, OUT PUINT ArraySize );

NdisGetBufferPhysicalArraySize함수는 주어진 버퍼 디스크립터 버퍼를 보조인 비연속적인 물리적 블럭들의 수를 리턴한다.

매개변수

Buffer

버퍼 디스크립터의 포인터.

ArraySize

이 함수가 보조 버퍼의 흩어져있는 물리 범위의 수를 리턴하는 호출자 할당 변수의 포인터.

주석

버스 마스터 DMA의 드라이버는 얼마나 많은 NDIS_PHYSICAL_ADDRESS구조체가 NdisMStartBufferPhysicalMapping함수를 호출하기전에 할당되고 채워져 있는지를 결정하기위해 호출 되어질수 있다.

프로토콜 드라이버는 하위 닉 드라이버를 위한 스케터 게더 리스트를 만들기위해 NdisGetBufferPhysicalArraySize함수를 호출 할수 있다. 그러나 그런 닉 지정 기능성을 가진 프로토콜 드라이버는 어떤 다른 닉 드라이버와 바인딩 될수 있을것 같지 않다.

버퍼내의 최대 물리 블럭들수는 이 함수가 쓰는것보다 하나가 더 많을수 있다. 페이지된 메모리내의 버퍼 배열에 의존하여. NdisGetBufferPhysicalArraySize함수는 주어진 길이의 버퍼를 보조하기위해 필요한 페이지 수를 리턴해서 만약 버퍼 디스크립터가 실제로 페이지 내의 옵세에서 시작한다면, 이 호출에 의해 리턴된 값은 페이지 틈(BREAK)보다 하나 작다.

드라이버는 NdisGetBufferPhysicalArraySize함수를 호출하기전에 가지고 있던 스핀 락을 해제해야만 한다.

NdisGetBufferPhysicalArraySize함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작한다.