NdisMAllocateSharedMemoryAsync

NDIS_STATUS NdisMAllocateSharedMemoryAsync( IN NDIS_HANDLE MiniportAdapterHandle, IN ULONG Length, IN BOOLEAN Cached, IN PVOID Context );

보통 미니포트가 이용할 수 있는 NIC 리시브 버퍼가 저조할 때 NdisMAllocateSharedMemoryAsync 함수는 미니포트와 버스마스터 DMA NIC 사이에 공유된 추가 메모리를 할당한다.

매개변수

MiniportAdapterHandle

MiniportInitialize로 들어오는 원래의 핸들을 서술한다..

Length

할당할 바이트 수를 서술한다.

Cached

메모리가 캐쉬될 수 있다면 TRUE를 서술한다.

Context

MiniportAllocateComplete 함수가 호출될 때 MiniportAllocateComplete 함수로 전해지는 드라이버가 결정한 컨텍스트를 가리킨다.

리턴값

다음중 하나를 리턴할 수 있다:

NDIS_STATUS_PENDING

호출자의 MiniportAllocateComplete 함수는 맵된 가상의 그리고 장치에 접근 가능한 공유 메모리 범위에 대한 논리 기본 주소들을 가지고 호출된다. 여기서 범위는 요청된 메모리가 할당됐을 때 그것의 길이와 컨텍스트의 포인터이다. 반면에 MiniportAllocateComplete 함수는 공유 메모리의 할당 시도가 실패할 경우 NULL 포인터를 가지고 호출된다.

NDIS_STATUS_FAILURE

이 경우 요청된 메모리는 할당될 수 없다. NdisMAllocateSharedMemoryAsync 함수가 이 상태를 리턴한다면, 똑같은 파라미터를 갖는 다음 호출은 성공할지도 모른다. 이는 시스템 리소스의 사용가능 여부에 달려있다.

주석

높은 네트워크 트래픽이 드라이버가 초기화 동안에 할당한 공유 메모리 공간에 과도한 요구를 할 때 버스마스터 DMA NIC의 드라이버는 전달기능에 대한 공유 메모리를 동적으로 할당하기 위해 NdisMAllocateSharedMemoryAsync를 호출한다.

그러한 NIC 드라이버는 들어오는 전달에 대해 사용가능한 공유 메모리 버퍼의 수를 기록하기 위해 보통 하나나 그 이상의 상태 변수를 유지한다. 사용가능한 버퍼의 수가 드라이버 결정 Low 일 때, 미니포트는 공유 메모리 공간에 그 이상의 버퍼 공간을 할당하기 위해 NdisMAllocateSharedMemoryAsync 함수를 호출한다. 사용가능한 버퍼의 수가 드라이버 결정 high일 때, 미니포트는 이전 동적 할당에 대한 해제로 NdisMFreeSharedMemory 함수를 여러번 호출한다.

보통 그러한 드라이버는 MiniportHalt 함수가 호출됐울 때 MiniportInitialize 함수가 NdisMAllocateSharedMemory 함수를 가지고 할당했던 공유 메모리 블럭을 NIC이 제거될 때까지 유지한다. 이 할당은 NIC을 통한 전달에 대한 평균적 요구를 처리하기에는 충분하다.

NdisMAllocateSharedMemoryAsync이나 NdisMAllocateSharedMemory 함수를 호출하는 어떤 미니포트는 NIC을 제거할 때 여러번의 NdisMFreeSharedMemory 함수 호출을 통해서 미해결의 모든 할당을 해제해야한다.

NdisMAllocateSharedMemoryAsync 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.