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 を呼び出すとエラーになります。

要件

こちらもご覧ください

KeInitializeDeviceQueue

KeInsertByKeyDeviceQueue

KeInsertDeviceQueue

KeRemoveDeviceQueue

KeRemoveEntryDeviceQueue