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

傳回值

備註

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

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

規格需求

   
結束支援 UMDF 2.0 和更新版本中無法使用。
目標平臺 桌面
最低 UMDF 版本 1.5
標頭 wudfddi.h (包括 Wudfddi.h)
DLL WUDFx.dll

另請參閱

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::P urge

IWDFIoQueue::Stop