MiniportAllocateComplete

VOID MiniportAllocateComplete( IN NDIS_HANDLE MiniportAdapterContext, IN PVOID VirtualAddress, IN PNDIS_PHYSICAL_ADDRESS PhysicalAddress, IN ULONG Length, IN PVOID Context );

MiniportAllocateComplete는 선택적인 함수이다. NdisMAllocateSharedMemoryAsync를 호출하는 버스 마스터 DMA NIC들의 드라이버에 의해 제공되어진다.

매개변수

MiniportAdapterContext

드라이버가 MiniportInitialize에 의해 설정된, NIC당 상태를 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다.

VirtualAddress

만약 할당 시도가 실패한다면은 NULL이고 혹은 NdisMAllocateSharedMemoryASync에 대한 선행 호출에 의해 할당된 공유 메모리의 기본 가상 주소를 지정한다.

PhysicalAddress

VirtualAddress에 대해 맵되어지고 NIC에 의해 사용이 알맞은 기본 실제 주소를 지정한다.

Length

NdisMAllocateSharedMemoryAsync에 대한 선행 호출에 의해 할당된 바이트 수를 지정한다.

Context

NdisMAllocateSharedMemoryAsync에 대한 선행 호출에서 전달된 드라이버 결정 컨텍스트를 가리킨다.

주석

버스 마스터 DMA NIC들의 드라이버들은 대부분 멀티패킷 리시브 인디케이션들을 지원함으로써 중요한 퍼포먼스 이득들을 얻는 것 같다. 높은 네트워크 트래픽에 기인해서 리시브 버퍼들을 위한 공유 메모리에서 적게 실행할 때 NdisMAllocateSharedMemoryAsync를 호출할 수 있게 하기 위해 MiniportAllocateComplete 함수를 제공한다.

NdisMAllocateSharedMemoryAsync는 가상 주소들을 사용하는 드라이버와 대응하는 실제 주소들을 사용하는 버스마스터 DMA NIC 사이에 공유할 수 있는 메모리를 할당한다. NdisMAllocateSharedMemoryAsync는 할당 시도가 성공이든 혹은 실패이든지 MiniportAllocateComplete를 호출한다.

NdisMAllocateSharedMemoryAsync에 대한 호출은 그것이 NdisMIndicateReceivePacket으로 바인드된 프로토콜들에게 들어오는 리시브들을 인디케이트할 때 가능한한 드라이버의 MiniportHandleInterrupt 혹은 MiniportTimer 함수로부터 IRQL <= DISPATCH_LEVEL에서 일어날 수 있다. 그러한 드라이버는 또한 MiniportReturnPacket 함수를 가져야 한다.

MiniportAllocateComplete은 NdisMAllocateSharedMemoryAsync에 대한 호출이 성공인지를 결정하기 위해 VirtualAddress의 값을 테스트해야 한다. 만약 호출이 성공적이라면은, VirtualAddress는 NULL이 아닌 값이다. 만약 호출이 실패한다면은, VirtualAddress는 NULL 값이다.

만약 NdisMAllocateSharedMemoryAsync가 성공적이라면은, MiniportAllocateComplete은 새롭게 할당된 공유 메모리 블럭내에 추가적인 리시브 버퍼들을 설정할 수 있다. 만약 이 호출이 캐쉬 메모리를 할당한다면은, MiniportAllocateComplete은 캐쉬 라인 경계에 각 새로운 리시브 버퍼를 정렬해야 한다. MiniportAllocateComplete은 버퍼 pool로부터 이러한 새로운 리시브 버퍼들을 맵하는 버퍼 디스크립터들을 할당해야 한다. 그러한 미니포트는 멀티 패킷 리시브 인디케이션들을 계속해서 할 수 있다 이것들은 NDIS가 이 함수를 익스포트한 바인드된 프로토콜의 ProtocolReceivePacket 함수에 포워드하거나 혹은 각 패킷들이 다른 바인드된 프로토콜의 ProtocolReceive 함수에 포워드된다.

만약 NdisMAllocateSharedMemoryAsync에 대한 호출이 실패한다면은, MiniportAllocateComplete이 드라이버가 계속해서 인디케이트하는 패킷들을 위해 아웃오브밴드블럭의 Status 멤버내에 NDIS_STATUS_RESOURCES를 설정해야 하는 것을 가리키는 MiniportAdapterContext 영역내에 상태 변수를 설정해야 한다. 이 상태는 NDIS가 미니포트가 NDIS_STATUS_RESOURCES가 설정하는 각 패킷으로 바인드된 프로토콜들의 ProtocolReceive 함수들을 호출하게 하고 그래서 프로토콜 드라이버들은 프로토콜이 모든 인디케이트된 데이터를 처리할 때까지 패킷들을 유지하는 것보다 인디케이트된 각 연결된 리시브 버퍼들을 가진 미니포트 할당 버퍼들을 해제한다. 미니포트의 존재하는 공유 메모리 영역내의 리시브 버퍼 공간이 보충되어진다면은 드라이버는 상태 변수를 리셋할 수 있고 NDIS_STATUS_SUCCESS로 패킷 배열들을 다시 인디케이트한다.

디폴트로, MiniportAllocateComplete은 IRQL DISPATCH_LEVEL에서 실행한다.