Funzioni video e immagini

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

Queste funzioni e macro modificano le strutture di formato video DirectShow.

Funzione	Descrizione
BIT_MASKS_MATCH	Confronta le maschere di colore per due strutture VIDEOINFO.
BITMASKS	Recupera le maschere di colore da una struttura VIDEOINFO
CheckVideoInfoType	Controlla un tipo di supporto che contiene una struttura di formato VIDEOINFOHEADER per gli errori che possono causare sovraccarichi del buffer o overflow interi.
CheckVideoInfo2Type	Controlla un tipo di supporto che contiene una struttura di formato VIDEOINFOHEADER2 per gli errori che possono causare sovraccarichi del buffer o overflow integer.
COLORS	Recupera le voci della tavolozza da una strutturaVIDEOINFO
ContainsPalette	Determina se una struttura VIDEOINFOHEADER specificata contiene una tavolozza.
ConvertVideoInfoToVideoInfo2	Converte un tipo di supporto che utilizza VIDEOINFOHEADER in uno che usa VIDEOINFOHEADER2
DIBSIZE	Calcola il numero di byte richiesti da una bitmap indipendente dal dispositivo (DIB).
GetBitCount	Restituisce il numero di bit per pixel utilizzati da un sottotipo di video specificato.
GetBitmapFormatSize	Calcola le dimensioni necessarie per una strutturaVIDEOINFO che può contenere una struttura BITMAPINFOHEADER specificata.
GetBitmapPalette	Restituisce la prima voce della tavolozza in una strutturaVIDEOINFOHEADER.
GetBitmapSize	Calcola il numero di byte richiesti da una bitmap indipendente dal dispositivo (DIB).
getBitmapSubtype	Restituisce il sottotipo multimediale GUID per la bitmap specificata.
GetSubtypeName	Recupera il nome leggibile di un sottotipo video.
GetTrueColorType	Restituisce il sottotipo multimediale GUID per una bitmap RGB non compressa a 16 bit.
INTESTAZIONE	Restituisce l'indirizzo delBITMAPINFOHEADERall'interno di un VIDEOINFOHEADER.
MPEG1_SEQUENCE_INFO	Restituisce l'indirizzo dell'intestazione della sequenza all'interno di una struttura MPEG1VIDEOINFO.
PALETTISED	Controlla se una bitmap ha una profondità di colore pari o inferiore a 8 bit.
PALETTE_ENTRIES	Recupera il numero massimo di colori nella tavolozza di una bitmap specificata.
RESET_MASKS	Riempie i campi della maschera colori in una struttura VIDEOINFO con zeri.
RESET_HEADER	Riempie un VIDEOINFOHEADER con zeri.
RESET_PALETTE	Riempie le voci della tavolozza in una struttura VIDEOINFO con zeri.
SIZE_EGA_PALETTE	Calcola le dimensioni necessarie per le voci della tavolozza in una bitmap RGB a 4 bit.
SIZE_MASKS	Calcola le dimensioni delle maschere di colore in una struttura VIDEOINFO.
SIZE_MPEG1VIDEOINFO	Calcola le dimensioni di una struttura MPEG1VIDEOINFO, inclusa l'intestazione della sequenza.
SIZE_PALETTE	calcola le dimensioni delle voci della tavolozza in una strutturaVIDEOINFO.
SIZE_PREHEADER	Calcola l'offset dei byte del campo bmiHeader all'interno di una strutturaVIDEOINFOHEADER.
SIZE_VIDEOHEADER	Calcola le dimensioni della struttura VIDEOINFOHEADER.
TRUECOLOR	Restituisce la strutturaTRUECOLORINFO da una strutturaVIDEOINFO.
ValidateBitmapInfoHeader	Controlla una struttura BITMAPINFOHEADER per individuare errori che possono causare sovraccarichi del buffer o overflow interi.

 

Osservazioni

La maggior parte delle macro e delle funzioni descritte nella sezione è progettata per modificare VIDEOINFOHEADER e strutture VIDEOINFO per bitmap RGB. Utilizzare queste macro con attenzione: la maggior parte di esse presuppone che la struttura specificata sia stata inizializzata correttamente. Molti di essi presuppongono anche che la struttura BITMAPINFOHEADER sia la dimensione standard; ovvero biSize == sizeof(BITMAPINFOHEADER).

La libreria di classi di base DirectShow fornisce anche le costanti globali seguenti, che definiscono le maschere di colore standard per le bitmap a colori reali.

Dati globali	Descrizione
bits555	Matrice di maschere di colore per una bitmap RGB a 16 bit in formato 5-5-5.
bits565	Matrice di maschere di colore per una bitmap RGB a 16 bit in formato 5-6-5.
bits888	Matrice di maschere di colore per una bitmap RGB a 24 bit.

 

Ognuna di queste costanti in una matrice di tre DWORDs, contenente le maschere rosse, verdi e blu, in tale ordine.