IMiniportMidiStream::Read メソッド (portcls.h)

[アーティクル]
02/29/2024

メソッドは Read 、受信 MIDI ストリームからデータを読み取ります。

構文

NTSTATUS Read(
  [in]  PVOID  BufferAddress,
  [in]  ULONG  BufferLength,
  [out] PULONG BytesRead
);

パラメーター

[in] BufferAddress

呼び出し元によって割り当てられたバッファーのアドレスを指定します。メソッドは、デバイスからバッファーに受信 MIDI データをコピーします。このバッファーの割り当てられたサイズは 、BufferLength 以上である必要があります。

[in] BufferLength

BufferAddress が指すバッファーの長さをバイト単位で指定します。

[out] BytesRead

メソッドがデバイスから正常に読み取られた実際のバイト数を指定するカウントをバッファーに書き込む呼び出し元によって割り当てられた変数への出力ポインター。

戻り値

Read は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。それ以外の場合、メソッドは適切なエラーコードを返します。次の表は、考えられる戻り状態コードの一部を示しています。

リターンコード	説明
STATUS_INVALID_DEVICE_REQUEST	デバイス要求が無効です (たとえば、MIDI 出力ストリームでを呼び出す `Read` )。

注釈

ミニポートドライバーは、IPortMidi::Notify を呼び出して、受信 MIDI データがキャプチャデバイスから使用可能になったときにポートドライバーに通知します。ポートドライバーは IMiniportMidi::Read を呼び出してデータを取得します。ポートドライバーは、使用可能なデータが増える限り、引き続きを呼び出 Read します。

メソッドは Read 、デバイスから現在使用できる MIDI 入力データがないことを示すために、STATUS_SUCCESSと BytesRead カウントを 0 で返します。