ExAllocateFromNPagedLookasideList 関数 (wdm.h)
ExAllocateFromNPagedLookasideList ルーチンは、指定されたルックアサイド リストから非ページ エントリへのポインターを返すか、新しく割り当てられた非ページ エントリへのポインターを返します。
構文
PVOID ExAllocateFromNPagedLookasideList(
[in, out] PNPAGED_LOOKASIDE_LIST Lookaside
);
パラメーター
[in, out] Lookaside
呼び出し元が ExInitializeNPagedLookasideList で既に初期化されているルックアサイド リストのNPAGED_LOOKASIDE_LIST構造体へのポインター。
戻り値
ExAllocateFromNPagedLookasideList は、エントリを割り当てることができる場合は、エントリへのポインターを返します。 それ以外の場合は、 NULL を返します。
解説
注意事項
バージョン 22H2 Windows 11以降、この関数はインラインからエクスポートに変更されました。 その結果、最新バージョンの Windows を対象にしてドライバーをビルドすると、古い OS バージョンでは読み込みに失敗します。 Visual Studio でターゲット OS のバージョンを変更するには、[構成プロパティ] -[ドライバーの設定] ->>[全般] の順に選択します。
指定されたルックアサイド リストが空でない場合、 ExAllocateFromNPagedLookasideList は リストから最初のエントリを削除し、このエントリへのポインターを返します。 それ以外の場合、 ExAllocateFromNPagedLookasideList は、リストの初期化時に指定された Allocate ルーチンを呼び出すか 、ExAllocatePoolWithTag を呼び出してエントリ ポインターを返します。
呼び出し元は、呼び出し元によって決定されたデータを使用して、返されたエントリを設定できます。 たとえば、ドライバーは、このような固定サイズの各エントリを使用して、特定の種類の I/O バス上の周辺機器に SCSI SRB などのコマンド ブロックを設定する場合があります。 呼び出し元は、 ExFreeToNPagedLookasideList が使用されなくなったときに、各エントリを解放する必要があります。
詳細については、「Lookaside Listsの使用」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
こちらもご覧ください
ExAllocateFromPagedLookasideList