comando MCI_SETVIDEO

  • Articolo

Il comando MCI_SETVIDEO imposta i valori associati alla riproduzione video. I dispositivi digital-video e VCR riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETVIDEO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetVideo
);

Parametri

wDeviceID

Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.

Dwflags

MCI_NOTIFY, MCI_WAIT o MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.

lpSetVideo

Puntatore a una struttura MCI_GENERIC_PARMS . I dispositivi con set di comandi estesi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo "digitalvideo":

MCI_DGV_SETVIDEO_ALG

Il membro lpstrAlgorithm della struttura identificata da lpSetVideo contiene un indirizzo di un buffer contenente il nome di un algoritmo di compressione video. L'algoritmo di compressione viene usato dai comandi successivi MCI_RESERVE o MCI_RECORD . Gli algoritmi disponibili dipendono dal dispositivo.

Se l'algoritmo specificato non è compatibile con il formato di file corrente, il formato del file viene modificato nel formato predefinito per l'algoritmo.

MCI_DGV_SETVIDEO_CLOCKTIME

Se usato con MCI_DGV_SETVIDEO_OVER, indica che l'ora viene specificata in millisecondi ed è tempo assoluto. Questa volta non è in fase di riproduzione dell'area di lavoro.

MCI_DGV_SETVIDEO_INPUT

Modifica i MCI_DGV_SETVIDEO_BRIGHTNESS,MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESSoMCI_DGV_SETVIDEO_TINT in modo che influisca sul segnale di input e modifica ciò che viene registrato. Se possibile, si tratta dell'impostazione predefinita quando si monitora l'input.

MCI_DGV_SETVIDEO_ITEM

Una costante video viene specificata nel membro dwItem della struttura identificata da lpSetVideo. La costante identifica il valore impostato. È possibile specificare le costanti seguenti con questo flag:

MCI_AVI_SETVIDEO_DRAW_PROCEDURE

Un nuovo indirizzo della routine di disegno viene specificato nel membro dwValue della struttura identificata da lpSetVideo. È possibile specificare una nuova procedura di disegno solo quando il dispositivo è inattiva. Questo flag viene riconosciuto solo dal driver digitale-video MCIAVI. Non esiste alcun valore equivalente a questo flag nell'interfaccia dei comandi stringa.

MCI_AVI_SETVIDEO_PALETTE_COLOR

Un nuovo colore della tavolozza viene specificato nei membri dwOver e dwValue della struttura identificata da lpSetVideo. Il membro dwOver specifica l'indice della tavolozza del colore da modificare e il membro dwValue specifica il nuovo colore, come valore RGB. È anche necessario specificare i flag di MCI_DGV_SETVIDEO_OVER e MCI_DGV_SETVIDEO_VALUE con MCI_DGV_SETVIDEO_ITEM quando si usa questa costante. Questo flag viene riconosciuto solo dal driver digitale-video MCIAVI.

MCI_AVI_SETVIDEO_PALETTE_HALFTONE

Indica che la tavolozza halftone deve essere usata anziché la tavolozza predefinita. Questo flag viene riconosciuto solo dal driver digitale-video MCIAVI.

MCI_DGV_SETVIDEO_BITSPERPEL

Il numero di bit per pixel viene specificato nel membro dwValue della struttura identificata da lpSetVideo. Il numero di bit per pixel viene usato per salvare i dati acquisiti o registrati

MCI_DGV_SETVIDEO_BRIGHTNESS

Il livello di luminosità video viene specificato come fattore nel membro dwValue della struttura identificata da lpSetVideo.

MCI_DGV_SETVIDEO_COLOR

Il livello di saturazione del colore video viene specificato come fattore nel membro dwValue della struttura identificata da lpSetVideo.

MCI_DGV_SETVIDEO_CONTRAST

Il livello di contrasto video viene specificato come fattore nel membro dwValue della struttura identificata da lpSetVideo.

MCI_DGV_SETVIDEO_FRAME_RATE

La frequenza dei fotogrammi viene specificata nel membro dwValue della struttura identificata da lpSetVideo. La frequenza viene specificata in unità di fotogrammi al secondo volte 1000. Ad esempio, 29,97 fotogrammi al secondo viene specificato come 29970.

MCI_DGV_SETVIDEO_GAMMA

Un valore dell'esponente della correzione gamma viene specificato nel membro dwValue della struttura identificata da lpSetVideo. La correzione gamma regola il mapping tra l'intensità codificata nell'origine della presentazione e la luminosità visualizzata. Il valore è l'esponente moltiplicato per 1000. Ad esempio, 2200 indica un esponente della versione 2.2. Un valore pari a 1000 indica un esponente pari a 1, che non applica alcuna correzione gamma.

MCI_DGV_SETVIDEO_KEY_COLOR

Un colore della chiave viene specificato nel membro dwValue della struttura identificata da lpSetVideo. Il colore della chiave è un valore RGB.

MCI_DGV_SETVIDEO_KEY_INDEX

Un valore di indice chiave viene specificato nel membro dwValue della struttura identificata da lpSetVideo. Il parametro di indice è un indice del tavolozza fisico.

MCI_DGV_SETVIDEO_PALHANDLE

Un handle della tavolozza viene specificato nel membro dwValue della struttura identificata da lpSetVideo. L'handle della tavolozza è contenuto nella parola a basso ordine. I dispositivi digital-video non devono liberare la tavolozza passata con questo comando. Le applicazioni devono liberarlo dopo aver chiuso il dispositivo. Questo flag è supportato solo dai dispositivi che usano le tavolozze. Se questo handle di tavolozza specificato è zero, viene usata la tavolozza predefinita.

MCI_DGV_SETVIDEO_SHARPNESS

Un valore di nitidezza video viene specificato come fattore nel membro dwValue della struttura identificata da lpSetVideo.

MCI_DGV_SETVIDEO_SOURCE

Una costante che specifica l'origine dell'input video viene specificata nel membro dwValue della struttura identificata da lpSetVideo. Le costanti seguenti sono definite:

  • MCI_DGV_SETVIDEO_SRC_NTSC: televisione NTSC.
  • MCI_DGV_SETVIDEO_SRC_PAL: televisione PAL.
  • MCI_DGV_SETVIDEO_SRC_RGB: video RGB.
  • MCI_DGV_SETVIDEO_SRC_SECAM: televisione SECAM.
  • MCI_DGV_SETVIDEO_SRC_SVIDEO: S-Video.

MCI_DGV_SETVIDEO_STREAM

Un flusso video viene specificato nel membro dwValue della struttura identificata da lpSetVideo. Il valore intero specifica il flusso video riprodotto dall'area di lavoro. Se il flusso non è specificato e il formato di file non definisce un flusso predefinito, viene riprodotto il primo flusso video interleaved fisicamente.

MCI_DGV_SETVIDEO_TINT

Un valore di tinta video viene specificato come fattore nel membro dwValue della struttura identificata da lpSetVideo. In genere, questa regolazione viene modellata dopo il controllo tinta di molti set di televisori a colori, con 250 definiti come verdi, 750 definiti come rosso e 0 (o 1000) definiti come blu. Il valore nominale è sempre 500.

MCI_DGV_SETVIDEO_OUTPUT

Il flag MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS o MCI_DGV_SETVIDEO_TINT viene modificato in modo che influisca solo sul segnale visualizzato e non su ciò che viene registrato. Se possibile, si tratta dell'impostazione predefinita durante il monitoraggio di un file.

MCI_DGV_SETVIDEO_OVER

Un parametro di lunghezza della transizione è incluso nel membro dwOver della struttura identificata da lpSetVideo. La lunghezza della transizione specifica per quanto tempo (nel formato di ora corrente) deve essere necessario apportare una modifica. Se questo flag non viene usato, la modifica viene eseguita immediatamente.

MCI_DGV_SETVIDEO_QUALITY

Il membro lpstrQuality della struttura identificata da lpSetVideo contiene un indirizzo di un buffer che descrive la qualità del video. Una stringa di testo nel buffer specifica le caratteristiche dell'algoritmo di compressione video.

Il flag MCI_DGV_SETVIDEO_ALG può essere usato per selezionare un descrittore di qualità per l'algoritmo specificato. Se questo flag viene omesso, viene usato l'algoritmo corrente.

Gli algoritmi e i nomi dei descrittori disponibili dipendono dal dispositivo. Ogni dispositivo fornisce la documentazione per gli algoritmi disponibili e una descrizione dei nomi dei descrittori applicabili. Il comando MCI_QUALITY può definire nomi di descrittori aggiuntivi. Tutti i dispositivi supportano i descrittori "low", "medium" e "high". Il valore predefinito è specifico del driver.

MCI_DGV_SETVIDEO_RECORD

Specifica se la registrazione include o esclude i dati video. In combinazione con MCI_SET_ON, i dati video vengono registrati. In combinazione con MCI_SET_OFF, i dati video vengono esclusi. Il valore predefinito include i dati video.

MCI_DGV_SETVIDEO_SRC_NUMBER

Un numero per l'origine video viene specificato nel membro dwSourceNumber della struttura identificata da lpSetVideo. Se è presente più di un input del tipo specificato da MCI_DGV_SETVIDEO_VALUE, il valore seleziona l'input. Questo flag deve essere sempre usato con MCI_DGV_SETVIDEO_SOURCE. Se MCI_DGV_SETVIDEO_VALUE viene omesso, tuttavia, il numero di origine specificato indica l'origine assoluta da usare come specificato nel comando MCI_LIST .

MCI_DGV_SETVIDEO_STILL

Il nome dell'algoritmo o il valore di qualità specificato si applicano alle immagini ancora.

Ogni driver di dispositivo deve supportare un algoritmo "none", ovvero nessuna compressione. Questo è il valore predefinito. In questo caso, i dispositivi digital-video salvano immagini ancora come bitmap indipendenti dal dispositivo RGB (DIB).

MCI_DGV_SETVIDEO_VALUE

Un valore è incluso nel membro dwValue della struttura identificata da lpSetVideo. Il significato del valore viene specificato dal flag MCI_DGV_SETVIDEO_ITEM .

MCI_SET_OFF

Disabilita l'output video. Per i dispositivi digital-video, la disabilitazione dei video imposta i pixel nel rettangolo di destinazione definito dal comando MCI_PUT (o dal relativo valore predefinito, l'area client della finestra corrente) su un colore a tinta unita, ma non ha alcun effetto sul buffer dei fotogrammi. È possibile nascondere la finestra con il comando MCI_WINDOW , se necessario. L'origine del video, che si tratti dell'area di lavoro o di un input esterno, potrebbe continuare a archiviare nuove immagini nel buffer dei fotogrammi, ma non vengono visualizzate finché il video non è abilitato. Anche se le applicazioni devono usare il comando MCI_SETVIDEO per controllare questa funzione, i dispositivi digital-video devono comunque supportare questo flag. Il valore predefinito dopo l'apertura è attivato.

MCI_SET_ON

Abilita l'output video.

Per i dispositivi digital-video, il parametro lpSetVideo punta a una struttura MCI_DGV_SETVIDEO_PARMS .

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo "vcr":

MCI_VCR_SETVIDEO_RECORD

Imposta la registrazione video su on o off. Usato in combinazione con uno dei flag seguenti:

  • MCI_SET_ON. Registrazione video su.
  • MCI_SET_OFF. Registrazione video disattivata. Potrebbe essere necessario disattivare la registrazione dell'assemblaggio (usando il comando MCI_SET con il flag MCI_VCR_SET_ASSEMBLE_RECORD impostato su off) prima che la registrazione video possa essere disattivata.

MCI_TRACK

Il membro dwTrack della struttura identificata da lpSetVideo specifica la traccia interessata dal comando.

MCI_VCR_SETVIDEO_SOURCE

Imposta l'origine video e deve essere usata con il flag MCI_VCR_SETVIDEO_TO .

MCI_VCR_SETVIDEO_MONITOR

Imposta il monitoraggio dell'origine video e deve essere usato con il flag MCI_VCR_SETVIDEO_TO.

MCI_VCR_SETVIDEO_TO

Il membro dwTo della struttura identificata da lpSetVideo contiene una delle costanti seguenti:

**MCI\_VCR\_SRC\_TYPE\_TUNER**
**MCI\_VCR\_SRC\_TYPE\_LINE**
**MCI\_VCR\_SRC\_TYPE\_AUX**
**MCI\_VCR\_SRC\_TYPE\_GENERIC**
**MCI\_VCR\_SRC\_TYPE\_MUTE**
**MCI\_VCR\_SRC\_TYPE\_OUTPUT**
**MCI\_VCR\_SRC\_TYPE\_RGB**
**MCI\_VCR\_SETVIDEO\_NUMBER**

Il membro dwNumber della struttura identificata da lpSetVideo contiene l'input video (del tipo specificato nel membro dwTo ) da utilizzare.

Per i dispositivi VCR, il parametro lpSetVideo punta a una struttura MCI_VCR_SETVIDEO_PARMS .

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional [solo app desktop]
Server minimo supportato
 Windows 2000 Server [solo app desktop]
Intestazione
Mmsystem.h (include Windows.h)

Vedi anche

MCI

Comandi MCI