Share via

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

  • [アーティクル]

メソッドは 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 で返します。

要件

要件 値
対象プラットフォーム ユニバーサル
Header portcls.h (Portcls.h を含む)
IRQL DISPATCH_LEVEL

こちらもご覧ください

IMiniportMidiStream

IMiniportMidiStream::Write

IPortMidi::Notify