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

Siehe auch

IMediaDet-Schnittstelle

Fehler- und Erfolgscodes