IWDFDevice2：：StopIdle 方法 (wudfddi.h)
[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上，UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用 UMDF 使用者入門。]
StopIdle 方法會通知架構裝置必須放置在其運作中 (D0) 電源狀態。
語法
HRESULT StopIdle(
[in] BOOL WaitForD0
);
參數
[in] WaitForD0
布爾值，指出 StopIdle 何時會傳回。 如果 為 TRUE，它只會在指定的裝置進入 D0 裝置電源狀態之後傳回。 如果 為 FALSE，方法會立即傳回。
傳回值
如果作業成功，StopIdle 會傳回S_OK。 否則，方法可能會傳回下列其中一個值：
| 傳回碼 | Description |
|---|---|
|
呼叫驅動程式不是裝置的 電源原則擁有者。 |
|
裝置已經回到其工作狀態。 |
|
發生裝置失敗，且裝置無法進入其 D0 電源狀態。 |
這個方法可能會傳回 Winerror.h 包含的其他其中一個值。
備註
如果您的裝置在閑置時可以進入低電源狀態，您的驅動程式可能需要偶爾呼叫 StopIdle ，讓裝置回到其運作 (D0) 狀態，或防止裝置進入低電源狀態。
當裝置閑置且架構將 I/O 要求放在裝置的電源管理 I/O 佇列中時，驅動程式不需要呼叫 StopIdle 。 此外，當裝置閑置且偵測到喚醒訊號時，驅動程式不需要呼叫 StopIdle 。 在這兩種情況下，架構會要求總線驅動程式將裝置的電源狀態還原至 D0。
雖然驅動程式通常不需要在處理從電源管理的 I/O 佇列取得的 I/O 要求時呼叫 StopIdle ，但允許呼叫。 不過，從電源管理的 I/O 佇列處理 I/O 要求時，驅動程式不得將 WaitForD0 參數設定為 TRUE 。
如果您的驅動程式必須存取裝置，因為驅動程式在受電源管理的 I/O 佇列之外收到要求，所以必須呼叫 StopIdle 。 例如，您的驅動程式可能支援驅動程式定義的介面或需要存取裝置的 WMI 要求。 在此情況下，您必須確定裝置在驅動程式存取裝置之前處於其工作狀態，而且裝置會維持在其工作狀態，直到驅動程式完成存取裝置為止。
如果系統處於運作中狀態 (S0) 狀態，則呼叫 StopIdle 會強制裝置進入其運作 (D0) 狀態。 裝置會保持運作狀態，直到驅動程式呼叫 IWDFDevice2：：ResumeIdle 為止，當架構保持閑置狀態時，該架構可以將裝置置於低電源狀態。
第一次呼叫驅動程式的 IPnpCallback：：OnD0Entry 回呼方法之前，請勿呼叫 StopIdle。
只有在系統處於運作中狀態 (S0) 狀態時， 對 StopIdle 的呼叫才能將閒置裝置還原到其工作狀態。 如果當驅動程式呼叫 StopIdle 並將 WaitForD0 參數設定為 TRUE 時，系統進入低電源狀態時，函式不會傳回，直到系統回到其 S0 狀態為止。
每次對 StopIdle 的呼叫最後都必須接聽 ResumeIdle 的呼叫，否則如果裝置再次變成閑置狀態，則永遠不會回到低電源狀態。 StopIdle 的呼叫可以巢狀化，因此 ResumeIdle 的呼叫數目必須等於 StopIdle 的呼叫數目。
如需 StopIdle 和 ResumeIdle 的詳細資訊，請參閱 支援 UMDF 型驅動程式中的閒置 Power-Down。
範例
下列程式代碼範例會取得 IWDFDevice2 介面，然後呼叫 StopIdle。 StopIdle 會在裝置進入 D0 裝置電源狀態之後傳回。
IWDFDevice2 *pIWDFDevice2 = NULL;
HRESULT hr;
//
// Get a pointer to the IWDFDevice2 interface.
//
hr = pIWDFDevice->QueryInterface(__uuidof(IWDFDevice2),
(void**) &pIWDFDevice2);
if (SUCCEEDED(hr))
{
hr = pIWDFDevice2->StopIdle(TRUE);
}
...
SAFE_RELEASE(pIWDFDevice2);
規格需求
| 需求 | 值 |
|---|---|
| 終止支援 | 在 UMDF 2.0 和更新版本中無法使用。 |
| 目標平台 | 桌面 |
| 最低UMDF版本 | 1.9 |
| 標頭 | wudfddi.h (包含 Wudfddi.h) |
| Dll | WUDFx.dll |