IQueueCallbackIoCanceledOnQueue：：OnIoCanceledOnQueue 方法 (wudfddi.h)

發行項
02/27/2024

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

驅動程式的 OnIoCanceledOnQueue 事件回呼函式會通知驅動程式在 I/O 佇列中時已取消 I/O 要求。

語法

void OnIoCanceledOnQueue(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest
);

參數

[in] pWdfQueue

I/O 要求在取消時所在的 I/O 佇列 IWDFIoQueue 介面指標。

[in] pWdfRequest

I/O 要求的 IWDFIoRequest 介面指標。

傳回值

無

備註

當驅動程式呼叫 IWDFDevice：：CreateIoQueue 時，驅動程式會註冊 I/O 佇列的 IQueueCallbackIoCanceledOnQueue 介面和 OnIoCanceledOnQueue 回呼函式。如需如何註冊介面的詳細資訊，請參閱 IQueueCallbackIoCanceledOnQueue。

如果驅動程式註冊 I/O 佇列的 OnIoCanceledOnQueue 回呼函式，如果要求處理程式從 I/O 佇列收到 I/O 要求，驅動程式會呼叫 IWDFIoRequest：：ForwardToIoQueue 或 IWDFIoRequest2：：Requeue ，將要求重新佇列至 已註冊 OnIoCanceledOnQueue 回呼函式的 I/O 佇列，接著會取消相關聯的 I/O 作業。

在架構呼叫 OnIoCanceledOnQueue 回呼函式之後，驅動程式會擁有要求物件，因此必須取消要求。

架構不會針對架構從未傳遞至驅動程式的 I/O 要求呼叫驅動程式的 OnIoCanceledOnQueue 回呼函式。

架構會在判斷 I/O 要求已取消時立即呼叫 OnIoCanceledOnQueue 回呼函式，不論驅動程式為 I/O 佇列設定的分派方法為何。因此，即使驅動程式目前擁有來自佇列的另一個要求，架構也可以針對使用循序分派的佇列中要求呼叫 OnIoCanceledOnQueue 回呼函式。

如需 OnIoCanceledOnQueue 回呼函式的詳細資訊，請參閱取消 I/O 要求。