IMiniportMidiStream::Read-Methode (portcls.h)

Artikel
02/26/2024

Die Read -Methode liest Daten aus einem eingehenden MIDI-Stream.

Syntax

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

Parameter

[in] BufferAddress

Gibt die Adresse eines vom Aufrufer zugeordneten Puffers an. Die -Methode kopiert die eingehenden MIDI-Daten vom Gerät in den Puffer. Die zugeordnete Größe dieses Puffers muss größer oder gleich BufferLength sein.

[in] BufferLength

Gibt die Länge des Puffers in Bytes an, auf den bufferAddress verweist.

[out] BytesRead

Ausgabezeiger auf eine vom Aufrufer zugeordnete Variable, in die die Methode eine Anzahl schreibt, die die tatsächliche Anzahl von Bytes angibt, die erfolgreich vom Gerät in den Puffer gelesen wurden.

Rückgabewert

Read gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück. In der folgenden Tabelle sind einige der möglichen Rückgabecodes status aufgeführt.

Rückgabecode	Beschreibung
STATUS_INVALID_DEVICE_REQUEST	Ungültige Geräteanforderung (z. B. Aufrufen `Read` eines MIDI-Ausgabestreams).

Hinweise

Der Miniporttreiber ruft IPortMidi::Notify auf, um den Porttreiber zu benachrichtigen, wenn eingehende MIDI-Daten vom Aufnahmegerät verfügbar werden. Der Porttreiber ruft IMiniportMidi::Read auf, um die Daten abzurufen. Der Porttreiber ruft Read weiterhin auf, solange mehr Daten verfügbar sind.

Die Read -Methode gibt STATUS_SUCCESS und die BytesRead-Anzahl 0 zurück, um anzugeben, dass derzeit keine MIDI-Eingabedaten mehr vom Gerät verfügbar sind.