NdisMFreeSharedMemory
VOID
NdisMFreeSharedMemory(
IN NDIS_HANDLE MiniportAdapterHandle,
IN ULONG Length,
IN BOOLEAN Cached,
IN PVOID VirtualAddress,
IN NDIS_PHYSICAL_ADDRESS PhysicalAddress
);
|
NdisMFreeSharedMemory는 전에 버스마스터 DMA NIC의 드라이버에 의해 NdisMAllocateSharedMemory 혹은 NdisMAllocateSharedMemoryAsync에 의해 전에 할당된 메모리를 해제한다.
매개변수
- MiniportAdapterHandle
- 원래 MiniportInitialize에 대한 입력인 핸들을 지정한다.
- Length
- 원래 할당된 바이트 수들을 지정한다.
- Cached
- 만약 원래 할당이 캐쉬가 될 수 있다면은 TRUE를 지정한다.
- VirtualAddress
- NdisMAllocateSharedMemory(Async)에 의해 리턴된 베이스 가상 주소를 지정한다.
- PhysicalAddress
- NdisMAllcoateSharedMemory(Async)에 의해 리턴된 응답하는 실제 주소를 지정한다.
주석
만약 이미 NdisMAllcoateSharedMemory 혹은 NdisMAllocateSharedMemoryAsync에 대한 성공적인 호출을 만든다면은, 버스마스터 DMA 장치에 대한 NIC 드라이버는 만약 다음과 같은 어떤 경우가 일어난다면은 NdisMFreeSharedMemory를 호출한다.
- MiniportInitialize 함수는 NIC을 초기화할 수 없고, 그래서 이 함수는 제어를 리턴하기 전에 그러한 NIC을 위해 하드웨어 자원들에 대한 모든 존재하는 요구들을 해제해야 한다.
- 메모리를 할당한 미니포트가 제거되었을 때 NIC
- 드라이버가 시스템이 셧다운 되거나 혹은 네트워크 요소들을 재구성한 사용자가 기계에서 사용되었기 때문에 언로드된다.
- 드라이버가 NIC에 대한 I/O 요구가 많지만은 네트워크 트래픽이 지금 평균 레벨보다 낮을 때 NdisMAllocateSharedMemoryAsync로 추가적인 공유 메모리를 할당한다.
미니포트는 할당된 공유 메모리 범위내에서 부분범위를 해제하기 위해 NdisMFreeSharedMemory를 호출할 수 없다. NdisMFreeSharedMemory에 전달되는 매개변수들은 정확하게 NdisMAllocateSharedMemory 혹은 NdisMAllocateSharedMemoryAsync에 전달되어지는 것들과 정확하게 일치해야 한다.
NdisMFreeSharedMemory 함수는 MiniportShutdown 함수로부터 호출되어질 수 없다.
NdisMFreeSharedMemory의 호출자들은 MiniportHalt의 컨텍스트내에서 이 경우에는 이 함수의 호출자들은 IRQL PASSIVE_LEVEL에서 실행해야 한다. 를 제외해서 IRQL <= DISPATCH_LEVEL에서 실행한다.
|