IMiniportMidiStream::Read-Methode (portcls.h)
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 |
---|---|
|
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.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
Header | portcls.h (portcls.h einschließen) |
IRQL | DISPATCH_LEVEL |