Método CImagePalette.PreparePalette

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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 PreparePalette método configura uma paleta, com base em um tipo de mídia do filtro proprietário.

Sintaxe

HRESULT PreparePalette(
   const CMediaType *pmtNew,
   const CMediaType *pmtOld,
         LPSTR      szDevice
);

Parâmetros

pmtNew

Ponteiro para o novo tipo de mídia. O bloco de formato deve ser uma estrutura VIDEOINFOHEADER .

pmtOld

Ponteiro para o tipo de mídia antigo. Se o tipo de mídia estiver sendo definido pela primeira vez, esse parâmetro poderá ser um tipo vazio sem bloco de formato. Caso contrário, o bloco de formato deve ser uma estrutura VIDEOINFOHEADER .

szDevice

Ponteiro para uma cadeia de caracteres que contém o nome do dispositivo de exibição, conforme retornado pela função GDI EnumDisplayDevices . Para usar o dispositivo de exibição main, defina esse parâmetro como NULL.

Retornar valor

Retorna S_OK se a paleta foi atualizada ou S_FALSE se a paleta não foi alterada.

Comentários

Se a paleta precisar ser atualizada, esse método executará as seguintes ações:

• Chama CImagePalette::MakePalette para criar uma nova paleta lógica.
• Envia um evento EC_PALETTE_CHANGED para o Gerenciador de Grafo de Filtro.
• Chama CBaseWindow::SetPalette no objeto CBaseWindow .
• Chama CDrawImage::IncrementPaletteVersion no objeto CDrawImage .

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 CImagePalette