IMediaDet::EnterBitmapGrabMode-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 EnterBitmapGrabMode Methode wechselt den Mediendetektor in den Bitmap-Grabmodus und sucht das Filterdiagramm auf eine angegebene Zeit.

Syntax

HRESULT EnterBitmapGrabMode(
   double StreamTime
);

Parameter

StreamTime

Zeit in Sekunden, nach der das Diagramm sucht.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Ungültiges Argument.
VFW_E_INVALIDMEDIATYPE	Die Quelldatei verfügt nicht über einen Videostream.
VFW_E_TIME_EXPIRED	Timeout des Suchbefehls.

 

Bemerkungen

Legen Sie vor dem Aufrufen dieser Methode den Dateinamen und den Stream fest, indem Sie IMediaDet::p ut_Filename und IMediaDet::p ut_CurrentStream aufrufen.

Diese Methode fügt den Filter Sample Grabber in das Filterdiagramm ein. Sie können dann IMediaDet::GetSampleGrabber aufrufen, um einen Zeiger auf die ISampleGrabber-Schnittstelle zu erhalten. Sobald der Mediendetektor in den Bitmap-Grabmodus wechselt, funktionieren die verschiedenen Informationsmethoden in IMediaDet nicht mehr.

Die Methoden IMediaDet::GetBitmapBits oder IMediaDet::WriteBitmapBits versetzen den Mediendetektor auch in den Bitmap-Grabmodus.

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