IMediaDet::WriteBitmapBits-Methode

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Hinweis

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

 

Die WriteBitmapBits -Methode ruft einen Videoframe zur angegebenen Medienzeit ab und schreibt ihn in eine Datei. Der Videoframe ist immer im 24-Bit-RGB-Format.

Syntax

HRESULT WriteBitmapBits(
   double StreamTime,
   long   Width,
   long   Height,
   BSTR   Filename
);

Parameter

StreamTime

Zeitpunkt zum Abrufen des Videoframes.

Width

Breite des Bilds in Pixel.

Height

Höhe des Bilds in Pixel.

Filename

Pfad der Datei, in der die Bitmap gespeichert werden soll. Wenn die Datei bereits vorhanden ist, wird sie von dieser Methode überschrieben.

Rückgabewert

Gibt S_OK erfolgreich zurück. Gibt andernfalls einen HRESULT-Wert zurück, der die Ursache des Fehlers angibt. Mögliche Fehlercodes sind:

Rückgabecode Beschreibung
E_NOINTERFACE
 Der Filter Sample Grabber konnte dem Diagramm nicht hinzugefügt werden.
E_FAIL
 Fehler.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.
E_UNEXPECTED
 Unerwarteter Fehler.
STG_E_ACCESSDENIED
 Die Datei kann nicht überschrieben werden.
VFW_E_INVALIDMEDIATYPE
 Ungültiger Medientyp.

 

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.

Mit dieser Methode wird die Medienerkennung in den Bitmap-Grabmodus versetzt. Nachdem diese Methode aufgerufen wurde, funktionieren die verschiedenen Streaminformationsmethoden in IMediaDet nicht mehr, es sei denn, Sie erstellen eine neue instance der Medienerkennung.

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