IAllocatorMXF::GetBuffer-Methode (dmusicks.h)

Die GetBuffer -Methode ordnet einen Puffer für lange MIDI-Ereignisse zu.

Syntax

NTSTATUS GetBuffer(
  [out] PBYTE *ppBuffer
);

Parameter

[out] ppBuffer

Ausgabezeiger für den Puffer. Dieser Parameter verweist auf eine vom Aufrufer zugeordnete Zeigervariable, in die die Methode einen Zeiger in den Puffer schreibt.

Rückgabewert

GetBuffer gibt S_OK zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.

Hinweise

Der Miniporttreiber ruft diese Methode nur auf, wenn er große Datenblöcke an die Erfassungssenke senden muss. Insbesondere verwendet der Miniporttreiber diese Methode immer dann, wenn eine Komponente mehr Daten packen muss, als im uData-Member von DMUS_KERNEL_EVENT gespeichert werden können.

Die Größe des Puffers kann durch Aufrufen von IAllocatorMXF::GetBufferSize bestimmt werden. GetBufferSize muss nur einmal aufgerufen werden, da die Puffergröße für jede Zuweisungsimplementierung konstant ist.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dmusicks.h (einschließlich Dmusicks.h)
IRQL	<=DISPATCH_LEVEL

Weitere Informationen

DMUS_KERNEL_EVENT

IAllocatorMXF

IAllocatorMXF::GetBuffersize