IWDFIoQueue：：Stop 方法 (wudfddi.h)

  • 發行項

[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1，且較新版本的 #DAA2D7425D1BA421B9687C4EB5C59EDF8 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用 UMDF 使用者入門。]

Stop 方法可防止 I/O 佇列傳遞 I/O 要求，但佇列會接收並儲存新的要求。

語法

void Stop(
  [in, optional] IQueueCallbackStateChange *pStopComplete
);

參數

[in, optional] pStopComplete

IQueueCallbackStateChange 介面的指標，其方法是架構在驅動程式中的所有未完成 I/O 要求之後呼叫。 此參數是選擇性的，可以是 NULL。

傳回值

無

備註

對 Stop 的呼叫是異步的，會立即返回驅動程式。 驅動程式會在驅動程式中的所有未完成要求之後，透過提供的 IQueueCallbackStateChange 介面方法收到通知。

驅動程式應該確保在任何指定時間只有下列其中一個方法正在進行中：

例如，如果驅動程式先前呼叫 Stop，它應該先等候 pStopComplete 參數指向介面的通知，再呼叫 清空 或 清除。 違反此規則會導致主機進程終止。

Stop 方法可讓佇列接收新的要求，即使佇列未在稱為 Stop 的驅動程式之前收到新要求也 一樣。 例如，驅動程式可能會呼叫 IWDFIoQueue：:D rain，這會導致架構停止將新的 I/O 要求新增至佇列。 驅動程式的後續停止 呼叫會導致架構 繼續將要求新增至佇列。

規格需求

需求 值
終止支援 UMDF 2.0 和更新版本中無法使用。
目標平台 桌面
最低UMDF版本 1.5
標頭 wudfddi.h (包括 Wudfddi.h)
Dll WUDFx.dll

另請參閱

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue：:D rain

IWDFIoQueue：:P urge