Metodo CImagePalette.PreparePalette

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il PreparePalette metodo configura una tavolozza, in base a un tipo di supporto dal filtro proprietario.

Sintassi

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

Parametri

pmtNew: Puntatore al nuovo tipo di supporto. Il blocco di formato deve essere una struttura VIDEOINFOHEADER .
pmtOld: Puntatore al tipo di supporto precedente. Se il tipo di supporto viene impostato per la prima volta, questo parametro può essere un tipo vuoto senza blocchi di formato. In caso contrario, il blocco di formato deve essere una struttura VIDEOINFOHEADER .
szDevice: Puntatore a una stringa contenente il nome del dispositivo visualizzato, come restituito dalla funzione GDI EnumDisplayDevices . Per usare il dispositivo di visualizzazione principale, impostare questo parametro su NULL.

Valore restituito

Restituisce S_OK se la tavolozza è stata aggiornata o S_FALSE se la tavolozza non è stata modificata.

Commenti

Se è necessario aggiornare la tavolozza, questo metodo esegue le azioni seguenti:

Chiama CImagePalette::MakePalette per creare una nuova tavolozza logica.
Invia un evento EC_PALETTE_CHANGED a Filter Graph Manager.
Chiama CBaseWindow::SetPalette nell'oggetto CBaseWindow .
Chiama CDrawImage::IncrementPaletteVersion nell'oggetto CDrawImage .

Requisiti

Requisito	Valore
Intestazione	Winutil.h (include Streams.h)
Libreria	Strmbase.lib (build retail); Strmbasd.lib (build di debug)

Vedi anche

Classe CImagePalette

Condividi tramite