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 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | HwStorPortProhibitedDDDIs(storport)、IrqlDispatch(storport)、IrqlDispatch(storport)、IrqlDispatch(wdm) |
関連項目
KeInitializeDeviceQueue の
KeRemoveDeviceQueue の