共用方式為

IWDFIoQueue：:D rain 方法 （wudfddi.h）

  • 發行項

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

Drain 方法會指示佇列拒絕新的傳入 I/O 要求，並允許已排入佇列的要求傳遞給驅動程式進行處理。

語法

void Drain(
  [in, optional] IQueueCallbackStateChange *pDrainComplete
);

參數

[in, optional] pDrainComplete

IQueueCallbackStateChange 介面的指標，其方法架構會呼叫將佇列狀態傳遞給驅動程式。 架構會在所有要求完成或取消之後呼叫 方法，而且佇列是空的。 這個參數是選擇性的，而且可以 NULL。

傳回值

沒有

言論

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

例如，如果驅動程式先前呼叫 Drain，它應該等候介面方法的通知，指出驅動程式呼叫 Stop 或 Purge之前，pDrainComplet e 參數指向 。 違反此規則會導致主機進程終止。

要求

要求 價值
終止支援 UMDF 2.0 和更新版本中無法使用。
目標平臺 桌面
最低 UMDF 版本 1.5
標頭 wudfddi.h （包括 Wudfddi.h）
DLL WUDFx.dll

另請參閱

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue：:P urge

IWDFIoQueue：：Stop