CImageAllocator.CreateDIB-Methode

Artikel
07/28/2023

[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 CreateDIB Methode erstellt eine geräteunabhängige GDI-Bitmap (DIB). Der DIB wird in einem freigegebenen Mempory-Block zugeordnet, wodurch ein Kopiervorgang eliminiert wird, wenn der besitzereigene Filter das Bild durchleuchtet.

Syntax

HRESULT CreateDIB(
        LONG    InSize,
  [ref] DIBDATA &DibData
);

Parameter

InSize: Größe der Bitmap.
DibData [ref]: Verweis auf eine DIBDATA-Struktur . Die -Methode füllt diese Struktur mit Informationen zum DIB aus.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlercode zurück.

Anforderungen

Anforderung	Wert
Header	Winutil.h (streams.h einschließen)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CImageAllocator-Klasse
CImageAllocator::Alloc

Freigeben über