WdfDeviceStopIdleWithTag マクロ (wdfdevice.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfDeviceStopIdleWithTag マクロは、指定したフレームワーク デバイス オブジェクトの電源参照数をインクリメントし、ドライバーの現在のファイル名と行番号を参照に割り当てます。 マクロでは、参照にタグ値も割り当てられます。

構文

NTSTATUS WdfDeviceStopIdleWithTag(
    _In_ WDFDEVICE Device,
    _In_ BOOLEAN WaitForD0,
    _In_ PVOID Tag
);

パラメーター

[in] Device

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

[in] WaitForD0

WdfDeviceStopIdleWithTag がいつ返されるのか示すブール値。 TRUE の場合は、指定したデバイスが D0 デバイスの電源状態に入った後にのみ が返されます。 FALSE の場合、メソッドは直ちにを返します。

[in] Tag

フレームワークが電源参照の識別タグとして格納するドライバー定義の値。

戻り値

なし

解説

操作が成功した場合、 WdfDeviceStopIdleWithTag はSTATUS_SUCCESSを返します。

その他の戻り値は次のとおりです。

リターン コード 説明
STATUS_PENDING

デバイスは非同期的に電源を入れている。
STATUS_INVALID_DEVICE_STATE

ドライバーは、デバイスの電源ポリシー所有者ではありません。
STATUS_POWER_STATE_INVALID

デバイスの障害が発生し、デバイスは D0 電源状態に入ることができません。

メソッドは、他の NTSTATUS 値を返す場合があります。

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

ドライバーが WdfDeviceStopIdleWithTag を呼び出して参照カウントをインクリメントする場合、ドライバーは WdfDeviceResumeIdleWithTag を呼び出してカウントを減らす必要があります。

WdfDeviceStopIdle の代わりに WdfDeviceStopIdleWithTag を呼び出すと、Microsoft デバッガーで表示できる追加情報 (タグ値、行番号、ファイル名) が提供されます。 WdfDeviceStopIdleWithTag は、ドライバーの現在の行番号とファイル名を使用します。

!wdftagtracker デバッガー拡張機能を使用して、タグ、行番号、およびファイル名の値を表示できます。 デバッガー拡張機能は、ポインターと一連の文字の両方としてタグ値を表示します。

詳細フラグがオンの !wdfkd.wdfdevice を使用し、出力で !wdftagtracker へのリンクを見つけます。

kd> !wdfdevice <handle> f

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.15
最小 UMDF バージョン 2.15
Header wdfdevice.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL 「解説」を参照してください。
DDI コンプライアンス規則 DriverCreate、KmdfIrql、KmdfIrql2

こちらもご覧ください

WDF での電源参照リークのデバッグ

WdfDeviceResumeIdle

WdfDeviceResumeIdleWithTag

WdfDeviceStopIdle