IMediaDet::WriteBitmapBits-Methode
[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 |
|---|---|
|
Der Filter Sample Grabber konnte dem Diagramm nicht hinzugefügt werden. |
|
Fehler. |
|
Nicht genügend Arbeitsspeicher. |
|
Unerwarteter Fehler. |
|
Die Datei kann nicht überschrieben werden. |
|
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 |
|
| Bibliothek |
|
Siehe auch