IQueueCallbackWrite::OnWrite メソッド (wudfddi.h)

[アーティクル]
03/08/2023

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。ユニバーサル Windows ドライバーでは UMDF 2 を使用する必要があります。詳細については、「UMDF を使用したはじめに」を参照してください。

OnWrite メソッドは、アプリケーションが Microsoft Win32 WriteFile または WriteFileEx 関数を使用してデバイスに情報を書き込むときに書き込み要求を処理するために呼び出されます。

構文

void OnWrite(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToWrite
);

パラメーター

[in] pWdfQueue

要求が到着する I/O キューオブジェクトの IWDFIoQueue インターフェイスへのポインター。

[in] pWdfRequest

フレームワーク要求オブジェクトを表す IWDFIoRequest インターフェイスへのポインター。

[in] NumOfBytesToWrite

要求の書き込みバッファーのサイズ (バイト単位)。

戻り値

なし

解説

ドライバーは、IWDFDevice::CreateIoQueue メソッドを呼び出して I/O キューを作成するか、既定の I/O キューを構成するときに、IQueueCallbackWrite インターフェイスを登録します。

ドライバーは、すべての I/O キューに対して 1 つの OnWrite メソッドを実装することも、I/O キューごとに個別の OnWrite メソッドを実装することもできます。

OnWrite メソッドは、キューからすべての書き込み要求の種類を受け取ります。 (書き込み要求の種類は、要求のWDF_REQUEST_TYPE列挙型の WdfRequestWrite 値によって識別されます)。OnWrite メソッドは、受信した各書き込み要求を処理する必要があります。 UMDF ドライバーが I/O 要求を処理する方法の詳細については、「 I/O 要求の処理」を参照してください。

ドライバーは、IWDFIoRequest::GetWriteParameters メソッドと IWDFIoRequest::GetInputMemory メソッドを呼び出して、要求と書き込みバッファーに関する情報を取得できます。