Share via

Metodo CImagePalette.PreparePalette

  • Articolo

[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:

Requisiti

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

Vedi anche

Classe CImagePalette