ISampleGrabber::SetCallback-Methode

Hinweis

[Veraltet. Diese API kann aus zukünftigen Releases von Windows entfernt werden.]

Die SetCallback-Methode gibt eine Rückrufmethode an, die für eingehende Stichproben aufgerufen werden soll.

Syntax

HRESULT SetCallback(
   ISampleGrabberCB *pCallback,
   long             WhichMethodToCallback
);

Parameter

pCallback

Zeiger auf eine ISampleGrabberCB-Schnittstelle, die die Rückrufmethode enthält, oder NULL, um den Rückruf abzubrechen.

WhichMethodToCallback

Index, der die Rückrufmethode angibt. Dabei muss es sich um einen der folgenden Werte handeln.

Wert Beschreibung
0 Der Sample Grabber-Filter ruft die ISampleGrabberCB::SampleCB-Methode auf. Diese Methode empfängt einen IMediaSample-Zeiger.
1 Der Sample Grabber-Filter ruft die ISampleGrabberCB::BufferCB-Methode auf. Diese Methode empfängt einen Zeiger auf den Puffer, der im Medienbeispiel enthalten ist.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S _ OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Der Datenverarbeitungsthread wird blockiert, bis die Rückrufmethode zurückgegeben wird. Wenn der Rückruf nicht schnell zurückgegeben wird, kann dies die Wiedergabe beeinträchtigen.

Der Filter ruft die Rückruffunktion nicht für Prärollbeispiele oder für Beispiele auf, in denen der dwStreamId-Member der AM _ SAMPLE2 _ PROPERTIES-Struktur etwas anderes als AM _ STREAM MEDIA _ ist.

Hinweis

Die Headerdatei Qedit.h ist mit Direct3D-Headern nach Version 7 nicht kompatibel.

Hinweis

Laden Sie zum Abrufen von Qedit.h das Microsoft Windows SDK-Update für Windows Vista und .NET Framework 3.0herunter. 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
Qedit.h
Bibliothek
Strmiids.lib

Siehe auch

Verwenden des Beispielgrabbers

ISampleGrabber-Schnittstelle