共用方式為

IWDFIoQueue：：Stop 方法 （wudfddi.h）

  • 發行項

[警告： UMDF 2 是最新版本的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上對 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 參數指向驅動程式呼叫 Drain 或 Purge。 違反此規則會導致主機進程終止。

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