WdfDeviceGetDefaultQueue 関数 (wdfdevice.h)

[KMDF と UMDF に適用]

WdfDeviceGetDefaultQueue メソッドは、デバイスの既定の I/O キューへのハンドルを返します。

構文

WDFQUEUE WdfDeviceGetDefaultQueue(
  [in] WDFDEVICE Device
);

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

戻り値

操作が成功した場合、 メソッドはフレームワーク キュー オブジェクトへのハンドルを返します。 ドライバーがデバイスの既定の I/O キューを作成しなかった場合、メソッドは NULL を返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

既定の I/O キューの詳細については、「 I/O キューの作成」を参照してください。

次のコード例では、デバイスの既定の I/O キューへのハンドルを取得します。

WDFQUEUE DefaultQueue;

DefaultQueue = WdfDeviceGetDefaultQueue(Device);

要件

要件
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfdevice.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf)KmdfIrql(kmdf)KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)