IWDFIoQueue：:D rain 方法 (wudfddi.h)

  • 發行項

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

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

語法

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

參數

[in, optional] pDrainComplete

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

傳回值

無

備註

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

例如，如果驅動程式先前稱為 「清空」，它應該等候來自介面的通知， pDrainComplete 參數在驅動程式呼叫 Stop 或 Purge 之前指向該介面。 違反此規則會導致主機進程終止。

規格需求

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

另請參閱

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue：:P urge

IWDFIoQueue：：Stop