comando MCI_SET

Articolo
06/13/2023

Nota

Comunicazione senza pregiudizi Microsoft supporta un ambiente diversificato e inclusivo. All'interno di questo documento sono presenti riferimenti alla parola "slave". Guida per lo stile di Microsoft per Bias-Free Comunicazioni riconosce questo come parola di esclusione. Questa parola viene usata come è attualmente la parola utilizzata all'interno dei comandi. Per coerenza, questo documento contiene questa parola. Quando questa parola viene modificata nei comandi, questo documento verrà corretto in allineamento.

Il comando MCI_SET imposta le informazioni sul dispositivo. Audio CD, digital-video, midi sequencer, VCR, videodisc, video sovrimpressione e dispositivi waveform-audio riconoscono questo comando.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SET, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SET_PARMS) lpSet
);

Parametri

wDeviceID: Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.
Dwflags: MCI_NOTIFY, MCI_WAIT o, per i dispositivi digital-video e VCR, MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.
lpSet: Puntatore a una struttura MCI_SET_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 si applicano a tutti i dispositivi che supportano MCI_SET:

MCI_SET_AUDIO: Un numero di canale audio è incluso nel membro dwAudio della struttura identificata da lpSet. Questo flag deve essere usato con MCI_SET_ON o MCI_SET_OFF. Usare una delle costanti seguenti per indicare il numero di canale:
MCI_SET_AUDIO_ALL: Tutti i canali audio.
MCI_SET_AUDIO_LEFT: Canale sinistro.
MCI_SET_AUDIO_RIGHT: Canale destro.
MCI_SET_DOOR_CLOSED: Chiude la copertina multimediale (se presente).
MCI_SET_DOOR_OPEN: Apre la copertina multimediale (se presente).
MCI_SET_OFF: Disabilita il canale video o audio specificato.
MCI_SET_ON: Abilita il canale audio o video specificato.
MCI_SET_TIME_FORMAT: Un parametro di formato ora è incluso nel membro dwTimeFormat della struttura identificata da lpSet. I flag seguenti vengono usati con questo flag:
MCI_FORMAT_BYTES: All'interno di un formato di dati PCM (modularità del codice pulse), modifica la descrizione del membro temporale in byte per l'input o l'output. Riconosciuto dal tipo di dispositivo waveaudio .
MCI_FORMAT_FRAMES: I comandi successivi useranno frame. Riconosciuto dai tipi di dispositivo digitalvideo, vcr e videodisc .
MCI_FORMAT_HMS: Modifica il formato di tempo in ore, minuti e secondi. Riconosciuto dai tipi di dispositivo vcr e videodisc .
MCI_FORMAT_MILLISECONDS: Modifica il formato dell'ora in millisecondi. Riconosciuto da tutti i tipi di dispositivo.
MCI_FORMAT_MSF: Modifica il formato di tempo in minuti, secondi e fotogrammi. Riconosciuto dai tipi di dispositivo cdaudio e vcr .
MCI_FORMAT_SAMPLES: Modifica il formato dell'ora in esempi per l'input o l'output. Riconosciuto dal tipo di dispositivo waveaudio .
MCI_FORMAT_SMPTE_24, MCI_FORMAT_SMPTE_25 e MCI_FORMAT_SMPTE_30: Imposta rispettivamente il formato temporale su 24, 25 e 30 fotogrammi SMPTE (Society of Motion Picture e Television Engineers). Riconosciuto dai tipi di dispositivo sequencer e vcr .
MCI_FORMAT_SMPTE_30DROP: Imposta il formato di ora su 30 SMPTE a discesa. Riconosciuto dai tipi di dispositivo sequencer e vcr .
MCI_FORMAT_TMSF: Modifica il formato di tempo in tracce, minuti, secondi e fotogrammi. McI usa numeri di traccia continua. Riconosciuto dai tipi di dispositivo cdaudio e vcr .
MCI_SET_VIDEO: Imposta il segnale video su o disattivato. Questo flag deve essere usato con MCI_SET_ON o MCI_SET_OFF. I dispositivi che non dispongono di MCIERR_UNSUPPORTED_FUNCTION video restituiti.

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

MCI_DGV_SET_FILEFORMAT: Un parametro di formato file è incluso nel membro dwFileFormat della struttura identificata da lpSet. Per i dispositivi digital-video, il formato di file viene usato per salvare o acquisire comandi. Se omesso, il valore predefinito potrebbe essere impostato su un formato definito dal driver di dispositivo. Se il formato di file specificato è in conflitto con l'algoritmo e la qualità attualmente selezionati, vengono modificati in base ai valori predefiniti per il formato di file. Le costanti di formato file seguenti sono definite:
MCI_DGV_FF_AVI: Formato AVI.
MCI_DGV_FF_AVSS: Formato AVSS.
MCI_DGV_FF_DIB: Formato DIB.
MCI_DGV_FF_JFIF: Formato JFIF.
MCI_DGV_FF_JPEG: Formato JPEG.
MCI_DGV_FF_MPEG: Formato MPEG.
MCI_DGV_FF_RDIB: Formato DIB RLE.
MCI_DGV_FF_RJPEG: Formato RJPEG.
MCI_DGV_SET_SEEK_EXACTLY: Imposta il formato utilizzato per la posizione. Questo flag deve essere usato con MCI_SET_ON o MCI_SET_OFF. Se viene specificato MCI_SET_ON, la riproduzione o la registrazione accede esattamente al frame specificato con il flag di MCI_FROM. Ciò potrebbe aggiungere un ritardo aggiuntivo se il frame richiesto non è un fotogramma chiave. Se viene specificato MCI_SET_OFF, il dispositivo cercherà un'immagine del fotogramma chiave che precede il frame richiesto. Per alcuni file e dispositivi, questo potrebbe essere il primo frame del file. Il valore predefinito per questo flag dipende dal dispositivo.
MCI_DGV_SET_SPEED: Un parametro di velocità è incluso nel membro dwSpeed della struttura identificata da lpSet. La velocità viene specificata come rapporto tra la frequenza dei fotogrammi nominale e la frequenza di fotogrammi desiderata in cui la frequenza di fotogrammi nominale è designata come 1000. La mezza velocità è 500 e la doppia velocità è 2000. L'intervallo di velocità consentito dipende anche dal dispositivo e possibilmente dal file.
MCI_DGV_SET_STILL: Se usato con MCI_DGV_SET_FILEFORMAT, MCI_SET imposta il formato di file usato per i comandi di acquisizione.

Per i dispositivi digital-video, il parametro lpSet punta a una struttura MCI_DGV_SET_PARMS .

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

MCI_SEQ_FORMAT_SONGPTR: Imposta il formato dell'ora su unità puntatore del brano.
MCI_SEQ_SET_MASTER: Imposta il sequencer come origine dei dati di sincronizzazione e indica che il tipo di sincronizzazione viene specificato nel membro dwMaster della struttura identificata da lpSet. MCISEQ restituisce MCIERR_UNSUPPORTED_FUNCTION. Le costanti seguenti sono definite per il tipo di sincronizzazione:
MCI_SEQ_MIDI: Il sequencer invierà i dati di sincronizzazione del formato MIDI.
MCI_SEQ_SMPTE: Il sequencer invierà i dati di sincronizzazione del formato SMPTE.
MCI_SEQ_NONE: Il sequencer non invierà i dati di sincronizzazione.
MCI_SEQ_SET_OFFSET: Modifica l'offset SMPTE di una sequenza a quello specificato dal membro dwOffset della struttura identificata da lpSet. Ciò influisce solo sulle sequenze con un tipo di divisione SMPTE.
MCI_SEQ_SET_PORT: Imposta la porta MIDI di output di una sequenza su quella specificata dall'identificatore del dispositivo MIDI nel membro dwPort della struttura identificata da lpSet. Il dispositivo chiude la porta precedente (se presente) e tenta di aprire e usare la nuova porta. Se ha esito negativo, restituisce un errore e riapri la porta usata in precedenza (se presente). Le costanti seguenti sono definite per le porte:
MCI_SEQ_NONE: Chiude la porta usata in precedenza (se presente). Il sequencer si comporta esattamente come se una porta fosse aperta, ad eccezione di nessun messaggio MIDI inviato.
MIDI_MAPPER: Imposta la porta aperta sul mapper MIDI.
MCI_SEQ_SET_SLAVE: Imposta il sequencer per ricevere i dati di sincronizzazione e indica che il tipo di sincronizzazione viene specificato nel membro dwSlave della struttura identificata da lpSet. MCISEQ restituisce MCIERR_UNSUPPORTED_FUNCTION. Le costanti seguenti sono definite per il tipo di sincronizzazione:
MCI_SEQ_FILE: Imposta il sequencer per ricevere i dati di sincronizzazione contenuti nel file MIDI.
MCI_SEQ_MIDI: Imposta il sequencer per ricevere i dati di sincronizzazione MIDI.
MCI_SEQ_NONE: Imposta il sequencer per ignorare i dati di sincronizzazione in un flusso MIDI.
MCI_SEQ_SMPTE: Imposta il sequencer per ricevere i dati di sincronizzazione SMPTE.
MCI_SEQ_SET_TEMPO: Modifica il tempo della sequenza MIDI a quello specificato dal membro dwTempo della struttura a cui punta lpSet. Per le sequenze con tipo PPQN di divisione, il tempo viene specificato nei beat al minuto; per le sequenze con tipo di divisione SMPTE, il tempo viene specificato nei fotogrammi al secondo.

Per i dispositivi sequencer, il parametro lpSet punta a una struttura MCI_SEQ_SET_PARMS .

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

MCI_VCR_SET_ASSEMBLE_RECORD

Imposta il dispositivo su cui registrare in modalità di assemblaggio o inserimento (quando assembla è disattivato, l'inserimento è attivo e viceversa). Usare con uno dei flag seguenti:

MCI_SET_ON

Imposta il record di assemblaggio su e disattiva il record di inserimento. Registra tutte le tracce video, audio e timecode.

MCI_SET_OFF

Imposta l'attivazione del record di assemblaggio e attiva il record di inserimento. Quando assemblare il record è disattivato, è possibile selezionare singole tracce di video, audio e timecode per la registrazione.

MCI_VCR_SET_CLOCK

Il membro dwClock della struttura identificata da lpSet contiene la nuova ora dell'orologio.

MCI_VCR_SET_COUNTER_FORMA

Il membro dwCounterFormat della struttura identificata da lpSet contiene una costante che specifica il nuovo formato di contatore da utilizzare dal contatore dello stato. Per un elenco di costanti valide, vedere MCI_SET_TIME_FORMAT nell'elenco di flag aggiuntivi per questo comando.

MCI_VCR_SET_COUNTER_VALUE

Il membro dwCounterValue della struttura identificata da lpSet contiene il nuovo valore del contatore.

MCI_VCR_SET_INDEX

Il membro dwIndex della struttura identificata da lpSet contiene una costante che indica il contenuto della visualizzazione sullo schermo e deve essere una delle seguenti:

MCI_VCR_INDEX_COUNTER

Visualizza il contatore.

MCI_VCR_INDEX_DATE

Visualizza la data.

MCI_VCR_INDEX_TIME

Visualizza l'ora.

MCI_VCR_INDEX_TIMECODE

Visualizza il codice temporale.

Per altre informazioni, vedere il comando MCI_INDEX .

MCI_VCR_SET_PAUSE_TIMEOUT

Il membro dwPauseTimeout della struttura identificata da lpSet contiene la durata massima, in millisecondi, di un comando di sospensione.

MCI_VCR_SET_POSTROLL_DURATION

Il membro dwPostrollDuration della struttura identificata da lpSet contiene la lunghezza videotape, nel formato di tempo corrente, necessario per frenare il trasporto VCR quando viene eseguito un comando di arresto o sospensione.

MCI_VCR_SET_POWER

Imposta o disattiva l'alimentazione. Deve essere usato con uno dei flag seguenti:

MCI_SET_OFF

Disattiva l'alimentazione.

MCI_SET_ON

Attiva l'alimentazione.

MCI_VCR_SET_PREROLL_DURATION

Il membro dwPrerollDuration della struttura identificata da lpSet contiene la lunghezza del videotape, nel formato ora corrente, necessaria per stabilizzare l'output del registro virtuale.

MCI_VCR_SET_RECORD_FORMAT

Il membro dwRecordFormat della struttura identificata da lpSet contiene una costante che descrive la velocità del record, che deve essere una delle seguenti:

MCI_VCR_FORMAT_EP

Registra a velocità lenta.

MCI_VCR_FORMAT_LP

Registra a velocità media lenta.

MCI_VCR_FORMAT_SP

Registra a velocità standard.

MCI_VCR_SET_SPEED

Il membro dwSpeed della struttura identificata da lpSet contiene la nuova impostazione di velocità, dove 1000 è la velocità normale, 2000 è doppia velocità e 500 è metà velocità e così via.

MCI_VCR_SET_TAPE_LENGTH

Il membro dwTapeLength della struttura identificata da lpSet contiene la nuova lunghezza del nastro, purché la lunghezza del nastro non sia rilevabile.

MCI_VCR_SET_TIME_MODE

Il membro dwTimeMode della struttura identificata da lpSet contiene una costante che indica la nuova modalità temporale posizionale. Le costanti seguenti sono valide:

MCI_VCR_TIME_COUNTER

Forza il dispositivo a usare esclusivamente il contatore.

MCI_VCR_TIME_DETECT

Ogni volta che un nuovo videotape viene inserito nel dispositivo o la modalità cambia da non pronto a pronto, il dispositivo deve tentare di determinare se è disponibile timecode nel videotape. Se timecode è disponibile, usare timecode in tutti i comandi successivi che specificano posizioni. In caso contrario, usare il contatore.

MCI_VCR_TIME_TIMECODE

Forza il dispositivo a usare esclusivamente timecode.

MCI_VCR_SET_TRACKING

Tunes the speed of the VCR tape transport with a fine adjustment, and must be used with one of the following flags:

MCI_VCR_PLUS

Aumenta la velocità del trasporto nastro.

MCI_VCR_MINUS

Riduce la velocità del trasporto nastro.

MCI_VCR_RESET

Restituisce la regolazione del rilevamento su zero.

Per i dispositivi VCR, il parametro lpSet punta a una struttura MCI_VCR_SET_PARMS .

Il flag aggiuntivo seguente viene usato con il tipo di dispositivo videodisc :

MCI_VD_FORMAT_TRACK: Modifica il formato dell'ora in tracce. MCI usa numeri di traccia continui.

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

MCI_WAVE_INPUT: Imposta l'input utilizzato per la registrazione sul membro wInput della struttura identificata da lpSet.
MCI_WAVE_OUTPUT: Imposta l'output utilizzato per la riproduzione sul membro wOutput della struttura identificata da lpSet.
MCI_WAVE_SET_ANYINPUT: Qualsiasi input wave compatibile con il formato corrente può essere usato per la registrazione.
MCI_WAVE_SET_ANYOUTPUT: Qualsiasi output wave compatibile con il formato corrente può essere usato per la riproduzione.
MCI_WAVE_SET_AVGBYTESPERSEC: Imposta i byte al secondo utilizzati per la riproduzione, la registrazione e il salvataggio nel membro nAvgBytesPerSec della struttura identificata da lpSet.
MCI_WAVE_SET_BITSPERSAMPLE: Imposta i bit per campione usati per la riproduzione, la registrazione e il salvataggio nel membro nBitsPerSample del formato di dati PCM identificato da lpSet.
MCI_WAVE_SET_BLOCKALIGN: Imposta l'allineamento del blocco utilizzato per la riproduzione, la registrazione e il salvataggio nel membro nBlockAlign della struttura identificata da lpSet.
MCI_WAVE_SET_CHANNELS: Il numero di canali è indicato nel membro nChannels della struttura identificata da lpSet.
MCI_WAVE_SET_FORMATTAG: Imposta il tipo di formato utilizzato per la riproduzione, la registrazione e il salvataggio nel membro wFormatTag della struttura identificata da lpSet. Se si specifica WAVE_FORMAT_PCM viene modificato il formato in PCM.
MCI_WAVE_SET_SAMPLESPERSEC: Imposta i campioni al secondo utilizzati per la riproduzione, la registrazione e il salvataggio nel membro nSamplesPerSec della struttura identificata da lpSet.

Per i dispositivi waveform-audio, il parametro lpSet punta a una struttura MCI_WAVE_SET_PARMS .

Quando viene creato il file in cui archiviare i dati, vengono definite diverse proprietà di dati audio waveform. Queste proprietà descrivono come i dati sono strutturati all'interno del file e non possono essere modificati dopo l'inizio della registrazione. L'elenco seguente di flag identifica queste proprietà:

MCI_WAVE_SET_AVGBYTESPERSEC
MCI_WAVE_SET_BITSPERSAMPLE
MCI_WAVE_SET_BLOCKALIGN
MCI_WAVE_SET_CHANNELS
MCI_WAVE_SET_FORMATTAG
MCI_WAVE_SET_SAMPLESPERSEC

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