KeRemoveByKeyDeviceQueue 関数 (wdm.h)
KeRemoveByKeyDeviceQueue ルーチンは、並べ替えキー値に従って選択されたエントリを、指定されたデバイス キューから削除します。
構文
PKDEVICE_QUEUE_ENTRY KeRemoveByKeyDeviceQueue(
[in, out] PKDEVICE_QUEUE DeviceQueue,
[in] ULONG SortKey
);
パラメーター
[in, out] DeviceQueue
呼び出し元がストレージを提供する初期化されたデバイス キュー オブジェクトへのポインター。
[in] SortKey
DeviceQueue を検索するときに使用するキーを指定します。
戻り値
KeRemoveByKeyDeviceQueue は、削除されたデバイス キュー エントリを返します。は、キューが空の場合は NULL を 返します。
注釈
このルーチンは、 SortKey 以上の値を持つデバイス キュー内の最初のエントリを検索します。 このエントリが見つかると、このルーチンはデバイス キューからエントリを削除して返します。 そのようなエントリが見つからない場合は、キュー内の最初のエントリが返されます。 デバイス キューが空の場合、デバイスはビジー状態に設定され、 NULL ポインターが返されます。
デバイス キュー オブジェクトがビジー状態に設定されている場合、 KeRemoveByKeyDeviceQueue を呼び出すとエラーになります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | DISPATCH_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport)、 IrqlDispatch(storport)、IrqlDispatch(storport)、 IrqlDispatch(wdm) |