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 以遞減計數。
呼叫 WdfDeviceStopIdleWithTag，而不是 WdfDeviceStopIdle 會提供您可以在Microsoft調試程式中檢視的其他資訊（標記值、行號和檔名）。 WdfDeviceStopIdleWithTag 會使用驅動程式目前的行號和檔名。
您可以使用 ！wdftagtracker 調試程序擴展名來檢視標籤、行號和檔案名值。 調試程式延伸模組會將標籤同時顯示為指標和一系列字元。
使用 ！wdfkd.wdfdevice 搭配詳細資訊旗標，並在輸出中找出 ！wdftagtracker 連結：
kd> !wdfdevice <handle> f
需求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.15 |
| 最低 UMDF 版本 | 2.15 |
| 標題 | wdfdevice.h （包括 Wdf.h） |
| 程式庫 | Wdf01000.sys （KMDF）：WUDFx02000.dll （UMDF） |
| IRQL | 請參閱一節。 |
| DDI 合規性規則 | DriverCreate、KmdfIrql、KmdfIrql2 |
另請參閱
WDF 中的電源參考流失偵錯