NdisMFreeSharedMemory 関数 (ndis.h)

[アーティクル]
02/26/2024

NdisMFreeSharedMemory は、以前に NdisMAllocateSharedMemory またはによって割り当てられたメモリを解放します。DMA NIC のドライバーによる NdisMAllocateSharedMemoryAsyncEx。

構文

void NdisMFreeSharedMemory(
  [in] NDIS_HANDLE           MiniportAdapterHandle,
  [in] ULONG                 Length,
  [in] BOOLEAN               Cached,
  [in] PVOID                 VirtualAddress,
  [in] NDIS_PHYSICAL_ADDRESS PhysicalAddress
);

パラメーター

[in] MiniportAdapterHandle

MiniportInitializeEx に最初に入力されたハンドルを指定します。

[in] Length

最初に割り当てられたバイト数を指定します。

[in] Cached

元の割り当てがキャッシュ可能な場合は TRUE を 指定します。

[in] VirtualAddress

NdisMAllocateSharedMemory または NdisMAllocateSharedMemoryAsyncEx によって返される基本仮想アドレスを指定します。

[in] PhysicalAddress

NdisMAllocateSharedMemory または NdisMAllocateSharedMemoryAsyncEx によって返される対応する物理アドレスを指定します。

戻り値

なし

解説

NdisMAllocateSharedMemory またはへの呼び出しが既に成功している場合次のいずれかが発生した場合、DMA デバイスのミニポートドライバー は NdisMFreeSharedMemory を呼び出します。

その MiniportInitializeEx 関数は NIC を初期化できないため、この関数は、制御を返す前に、その NIC のハードウェアリソース上のすべての既存の要求を解放する必要があります。
ミニポートドライバーがメモリを割り当てた NIC が削除されています。
システムがシャットダウンしているか、ユーザーがマシンで使用されているネットワークコンポーネントを再構成したかに関係なく、ドライバーがアンロードされています。
NIC の I/O 要求が高かったが、ネットワークトラフィックが平均レベルに収まった場合、ドライバーは NdisMAllocateSharedMemoryAsyncEx を使用して追加の共有メモリを割り当てた。

ミニポートドライバーは、割り当てられた共有メモリ範囲内のサブ範囲を解放する NdisMFreeSharedMemory を呼び出すことはできません。 NdisMFreeSharedMemory に渡されるパラメーターは、NdisMAllocateSharedMemory または NdisMAllocateSharedMemoryAsyncEx に渡されたものと正確に一致する必要があります。

NdisMFreeSharedMemory は、MiniportShutdownEx 関数から呼び出すことはできません。

Microsoft Windows Server 2003、Windows XP Service Pack 1 以降のバージョンの Windows では、バスマスター DMA NIC と下位 DMA NIC の両方で NdisMFreeSharedMemory を呼び出すことができます。以前のリリースでは、バスマスター DMA NIC のみが NdisMFreeSharedMemory を呼び出すことができるようになります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisMFreeSharedMemory (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (NdisMFreeSharedMemory (NDIS 5.1) を参照) でサポートされています。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_Miniport_Driver_Function(ndis)、 NdisMFreeSharedMemory(ndis)