Método CImageAllocator.CreateDIB

Artigo
07/28/2023

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O CreateDIB método cria um DIB (bitmap independente de dispositivo) GDI. O DIB é alocado em um bloco de mempory compartilhado, o que elimina uma operação de cópia quando o filtro proprietário corta a imagem.

Sintaxe

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

Parâmetros

InSize: Tamanho do bitmap.
DibData [ref]: Referência a uma estrutura DIBDATA . O método preenche essa estrutura com informações sobre o DIB.

Retornar valor

Retorna S_OK se tiver êxito ou um código de erro de outra forma.

Requisitos

Requisito	Valor
parâmetro	Winutil.h (inclua Streams.h)
Biblioteca	Strmbase.lib (builds de varejo); Strmbasd.lib (builds de depuração)

Confira também

Classe CImageAllocator
CImageAllocator::Alloc

Compartilhar via