IUsbTargetPipeContinuousReaderCallbackReadComplete：：OnReaderCompletion 方法 (wudfusb.h)

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

驅動程式的 OnReaderCompletion 事件回呼函式會通知驅動程式連續讀取器已成功完成讀取要求。

語法

void OnReaderCompletion(
  [in] IWDFUsbTargetPipe *pPipe,
  [in] IWDFMemory        *pMemory,
  [in] SIZE_T            NumBytesTransferred,
  [in] PVOID             Context
);

參數

[in] pPipe

驅動程式已啟用連續讀取器的USB管道 IWDFUsbTargetPipe 介面指標。

[in] pMemory

讀取緩衝區的 IWDFMemory 介面指標，其中包含從USB管道讀取的數據。

[in] NumBytesTransferred

讀取緩衝區包含的位元組數目。

[in] Context

驅動程式提供之內容資訊的指標，該驅動程式先前稱為 IWDFUsbTargetPipe2：：ConfigureContinuousReader 時所提供的內容資訊。

傳回值

無

備註

若要註冊 IUsbTargetPipeContinuousReaderCallbackReadComplete：：OnReaderCompletion 回呼函式，您的驅動程式必須在呼叫 IWDFUsbTargetPipe2：：ConfigureContinuousReader 時提供驅動程式 IUsbTargetPipeContinuousReaderCallbackReadComplete 介面的指針。

如果驅動程式已建立 USB 管道的連續讀取器，則架構會在每次驅動程式的 I/O 目標成功完成讀取要求時呼叫驅動程式的 OnReaderCompletion 回呼函式。 如果 I/O 目標未順利完成要求，架構會呼叫驅動程式的 IUsbTargetPipeContinuousReaderCallbackReadersFailed：：OnReaderFailure 回呼函式。

若要存取包含從裝置讀取數據的緩衝區，驅動程式可以呼叫 IWDFMemory：：GetDataBuffer。 架構會將數據寫入緩衝區，在 IWDFUsbTargetPipe2：：ConfigureContinuousReader 的 HeaderLength 參數所定義的標頭之後。 請注意， IWDFMemory：：GetDataBuffer 傳回的指標會指向標頭的開頭，但 OnReaderCompletion 回呼函式的 NumBytesTransferred 參數不包含標頭的長度。

根據預設，架構會在 OnReaderCompletion 回呼函式傳回之後刪除緩衝區的記憶體物件。 不過，您可能會希望記憶體物件在回呼函式傳回之後保持有效。 例如，您可能希望驅動程式將記憶體物件的介面指標儲存在架構管道對象 的內容空間 中，讓驅動程式可以在回呼函式傳回之後處理記憶體物件的內容。 若要延長記憶體物件的存留期，回呼函式必須呼叫緩衝區的 IWDFMemory：：AddRef 方法。 接著，驅動程式必須呼叫緩衝區的 IWDFMemory：：Release 方法，讓架構可以刪除物件。

架構會根據下列規則同步處理 OnReaderCompletion 和 IUsbTargetPipeContinuousReaderCallbackReadersFailed：：OnReaderFailure 回呼函式的呼叫：

• 這些回呼函式不會針對個別 USB 管道同時執行。
• 如果驅動程式為多個 USB 管道建立多個連續讀取器，且有多個 OnReaderCompletion 和 OnReaderFailure 回呼函式，則多個回呼函式可以同時執行。
• 如果驅動程式在呼叫 IWDFUsbTargetPipe2：：ConfigureContinuousRead (er 時指定了預設的 NumPendingReads 值，或指定大於 1) 的任何 NumPendingReads 值，而且當 OnReaderCompletion 回呼函式執行時，如果讀取要求完成，架構可以在回呼函式傳回之前再次呼叫 OnReaderCompletion 回呼函式。
• 架構不會與任何其他回呼函式同步處理這些回呼函式。

如需 OnReaderCompletion 回呼函式和 USB I/O 目標的詳細資訊，請參閱 處理 USB I/O 目標。

規格需求

另請參閱

IUsbTargetPipeContinuousReaderCallbackReadComplete

IUsbTargetPipeContinuousReaderCallbackReadersFailed：：OnReaderFailure