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 |