Condividi tramite


Macro ICGetState (vfw.h)

La macro ICGetState esegue una query su un driver di compressione video per restituire la configurazione corrente in un blocco di memoria. È possibile utilizzare questa macro o chiamare in modo esplicito il messaggio di ICM_GETSTATE .

Sintassi

DWORD ICGetState(
     hic,
     pv,
     cb
);

Parametri

hic

Maniglia del compressore.

pv

Puntatore a un blocco di memoria per contenere le informazioni di configurazione correnti. È possibile specificare NULL per questo parametro per determinare la quantità di memoria necessaria per le informazioni di configurazione, come in ICGetStateSize.

cb

Dimensioni, in byte, del blocco di memoria.

Valore restituito

Tipo: DWORD

Se pv è NULL, restituisce la quantità di memoria, in byte, necessaria per le informazioni di configurazione. Se pv non è NULL, restituisce ICERR_OK in caso di esito positivo o un errore in caso contrario.

Osservazioni:

La macro ICGetStateSize restituisce il numero di byte utilizzati dai dati di stato.

La struttura usata per rappresentare le informazioni di configurazione è specifica del driver ed è definita dal driver.

Usare ICGetStateSize prima di chiamare la macro ICGetState per determinare le dimensioni del buffer da allocare per la chiamata.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Finestre
Intestazione vfw.h

Vedere anche

Macro di compressione video

Gestore di Compressione Video