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)

こちらもご覧ください

KeInitializeDeviceQueue

KeInsertByKeyDeviceQueue

KeInsertDeviceQueue

KeRemoveDeviceQueue

KeRemoveEntryDeviceQueue