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 |