NdisAllocateMemoryWithTagPriority 関数 (ndis.h)

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

NDIS ドライバーは NdisAllocateMemoryWithTagPriority 関数を呼び出して、ページ以外のプールからメモリプールを割り当てます。

構文

PVOID NdisAllocateMemoryWithTagPriority(
  [in] NDIS_HANDLE      NdisHandle,
  [in] UINT             Length,
  [in] ULONG            Tag,
  [in] EX_POOL_PRIORITY Priority
);

パラメーター

[in] NdisHandle

初期化中に呼び出し元が取得した NDIS ハンドル。たとえば、ミニポートドライバーは、から取得した NDIS ハンドルを使用できます。 NdisMRegisterMiniportDriver または MiniportInitializeEx 関数。他の NDIS ドライバーでは、次の関数のハンドルを使用できます。

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] Length

割り当てるサイズ (バイト単位)。

[in] Tag

一重引用符で区切られた文字列。最大 4 文字で、通常は逆の順序で指定されます。この呼び出しの NDIS 提供の既定のタグは "maDN" ですが、呼び出し元は明示的な値を指定することで、この既定値をオーバーライドできます。

[in] Priority

この要求の重要性。詳細については、「 ExAllocatePoolWithTagPriority。

戻り値

NdisAllocateMemoryWithTagPriority は、割り当てられたメモリのベース仮想アドレスへのポインターを返します。十分な非ページメモリが現在使用できない場合は NULL を 返します。

注釈

NdisAllocateMemoryWithTagPriority で割り当てられたメモリを解放するには、NdisFreeMemoryWithTagPriority または NdisFreeMemory 関数を呼び出します。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_Miscellaneous_Function(ndis)、 NdisAllocateMemoryWithTagPriority(ndis)、NdisAllocateMemoryWithTagPriority_Cleanup(ndis)、NdisAllocateMemoryWithTagPriority_InitFail(ndis)