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 |