IMediaDet::GetSampleGrabber-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 GetSampleGrabber -Methode ruft einen Zeiger auf die ISampleGrabber-Schnittstelle ab, mit der eine Anwendung einzelne Beispiele aus einem Mediendatenstrom abrufen kann.
Syntax
HRESULT GetSampleGrabber(
[out] ISampleGrabber **ppVal
);
Parameter
-
ppVal [out]
-
Empfängt einen Zeiger auf die ISampleGrabber-Schnittstelle .
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Bemerkungen
Rufen Sie IMediaDet::EnterBitmapGrabMode auf, bevor Sie diese Methode aufrufen. Mit der ISampleGrabber-Schnittstelle können Sie einzelne Medienbeispiele aus dem Stream abrufen. Wenn Sie nur eine Bitmap aus einem Videoframe benötigen, rufen Sie stattdessen die IMediaDet::GetBitmapBits-Methode auf. Die ISampleGrabber-Schnittstelle ist flexibler, erfordert jedoch mehr Arbeit für die Anwendung.
Wenn diese Methode erfolgreich ist, weist die zurückgegebene ISampleGrabber-Schnittstelle eine ausstehende Verweisanzahl auf. Stellen Sie sicher, dass Sie die Schnittstelle freigeben, wenn Sie sie verwenden.
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