CImageAllocator.CreateDIB-Methode

  • Artikel

[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