IMediaDet::GetSampleGrabber-Methode

Hinweis

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

Die GetSampleGrabber -Methode ruft einen Zeiger auf die ISampleGrabber-Schnittstelle ab, die es einer Anwendung ermöglicht, einzelne Beispiele aus einem Medienstream abzurufen.

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 HRESULT-Fehlercode zurückgegeben.

Hinweise

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 durch die Anwendung.

Wenn diese Methode erfolgreich ist, verfügt die zurückgegebene ISampleGrabber-Schnittstelle über einen ausstehenden Verweiszähler. Stellen Sie sicher, dass Sie die Schnittstelle freigeben, wenn Sie sie nicht mehr verwenden.

Hinweis

Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern kompatibel, die höher als Version 7 sind.

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

IMediaDet-Schnittstelle

Fehler- und Erfolgscodes