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.]

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:

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.

Anforderungen

Siehe auch

IMediaDet-Schnittstelle

Fehler- und Erfolgscodes