次の方法で共有

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

  • [アーティクル]

[警告: 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 キューに対して単一の OnWrite メソッドを実装することも、I/O キューごとに個別の OnWrite メソッドを実装することもできます。

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

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

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wudfddi.h (Wudfddi.h を含む)

関連項目

IQueueCallbackWrite を する

IWDFDevice::CreateIoQueue

IWDFIoQueue の

IWDFIoRequest の

WDF_REQUEST_TYPE