NdisAllocateMemoryWithTagPriority 関数 (ndis.h)
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 ドライバーでは、次の関数のハンドルを使用できます。
[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) |