ISampleGrabberCB::BufferCB-Methode
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Hinweis
[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]
Die BufferCB-Methode ist eine Rückrufmethode, die einen Zeiger auf den Beispielpuffer empfängt.
Syntax
HRESULT BufferCB(
double SampleTime,
BYTE *pBuffer,
long BufferLen
);
Parameter
-
SampleTime
-
Startzeit des Beispiels in Sekunden.
-
pBuffer
-
Zeiger auf einen Puffer, der die Beispieldaten enthält. Das Format der Daten hängt vom Medientyp des Eingabenadels des Beispielgrabbers ab. Um den Medientyp abzurufen, rufen Sie ISampleGrabber::GetConnectedMediaType auf.
-
BufferLen
-
Länge des Puffers, auf den pBuffer in Bytes verweist.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen HRESULT-Fehlercode zurück.
Bemerkungen
Diese Rückrufmethode empfängt einen Zeiger auf die Daten im neuesten Medienbeispiel.
Hinweis
Diese Methode empfängt einen Zeiger auf die ursprünglichen Beispieldaten, nicht eine Kopie. In der ursprünglichen Dokumentation wurde fälschlicherweise angegeben, dass pBuffer eine Kopie der Daten enthält.
Um den Rückruf einzurichten, rufen Sie ISampleGrabber::SetCallback auf.
Hinweis
Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern ab Version 7 kompatibel.
Hinweis
Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch