ISampleGrabber::SetCallback-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Hinweis

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

 

Die SetCallback-Methode gibt eine Rückrufmethode an, die bei eingehenden Beispielen 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 Beispielgrabberfilter ruft die ISampleGrabberCB::SampleCB-Methode auf. Diese Methode empfängt einen IMediaSample-Zeiger .
1	Der Filter Sample Grabber 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 Fehlercode HRESULT zurückgegeben.

Bemerkungen

Der Datenverarbeitungsthread 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 Vorabrollbeispiele oder für Beispiele auf, bei denen der dwStreamId-Member der AM_SAMPLE2_PROPERTIES-Struktur nicht AM_STREAM_MEDIA ist.

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	Qedit.h
Bibliothek	Strmiids.lib

Siehe auch

Verwenden des Beispielgrabbers

ISampleGrabber-Schnittstelle