WdfDeviceResumeIdleWithTag マクロ (wdfdevice.h)

[KMDF と UMDF に適用]

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

構文

void WdfDeviceResumeIdleWithTag(
  [in]  Device,
  [in]  Tag
);

パラメーター

[in] Device

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

[in] Tag

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

戻り値

なし

解説

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

オブジェクトの参照カウントが 0 になると、 WdfDeviceResumeIdleWithTag が返される前にオブジェクトが削除される可能性があります。

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

!wdfkd.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	<= DISPATCH_LEVEL
DDI コンプライアンス規則	DriverCreate、KmdfIrql、KmdfIrql2

こちらもご覧ください

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

WdfDeviceResumeIdle

WdfDeviceStopIdle

WdfDeviceStopIdleWithTag