comando set

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 set stabilisce le impostazioni di controllo per il 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 mciSendString con il set di parametri lpszCommand come indicato di seguito.

_stprintf_s(
  lpszCommand,
  TEXT("set %s %s %s"),
  lpszDeviceID,
  lpszSetting,
  lpszFlags
);
      

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato quando il dispositivo viene aperto.

lpszSetting

Contrassegno per stabilire le impostazioni di controllo. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando set e i flag usati da ogni tipo.

Tipo di dispositivo Flag di comando
cdaudio
  • audio tutto disattivato
  • audio tutto su
  • audio lasciato disattivato
  • audio a sinistra
  • audio immediatamente disattivato
  • audio a destra
  • porta chiusa
  • porte aperte
  • millisecondi di formato ora
  • formato ora msf
  • formato time tmsf
digitalvideo
  • audio tutto disattivato
  • audio tutto su
  • audio lasciato disattivato
  • audio a sinistra
  • audio immediatamente disattivato
  • audio a destra
  • porta chiusa
  • porte aperte
  • formato file
  • cercare esattamente su
  • cercare esattamente fuori
  • fattore di velocità
  • formato di file ancora
  • fotogrammi di formato temporale
  • millisecondi di formato ora
  • video disattivato
  • video su
overlay
  • audio tutto disattivato
  • audio tutto su
  • audio lasciato disattivato
  • audio a sinistra
  • audio immediatamente disattivato
  • audio a destra
  • porta chiusa
  • porte aperte
  • video disattivato
  • video su
sequencer
  • audio tutto disattivato
  • audio tutto su
  • audio lasciato disattivato
  • audio a sinistra
  • audio immediatamente disattivato
  • audio a destra
  • porta chiusa
  • porte aperte
  • master MIDI
  • master none
  • master SMPTE
  • tempo di offset
  • mapper di porta
  • porta none
  • porta port_number
  • file slave
  • SLAVE MIDI
  • slave none
  • slave SMPTE
  • tempo tempo_value
  • millisecondi di formato ora
  • formato temporale SMPTE fps
  • formato ora SMPTE 30 drop
  • puntatore del formato ora
Vcr
  • assemblare il record su
  • assemblare il record fuori
  • audio tutto disattivato
  • audio tutto su
  • audio lasciato disattivato
  • audio a sinistra
  • audio immediatamente disattivato
  • audio a destra
  • ora dell'orologio
  • formato contatore
  • valore del contatore
  • porta chiusa
  • porta aperta
  • contatore dell'indice
  • data dell'indice
  • ora dell'indice
  • ora dell'indice
  • durata codelength
  • timeout pausa
  • durata postroll -
  • duration
  • accensione
  • spegnimento
  • durata preroll
  • formato record SP
  • formato record LP
  • formato record EP
  • fattore di velocità
  • fotogrammi di formato ora
  • formato ora hms
  • formato ora millisecondi
  • formato ora msf
  • formato ora SMPTE fps
  • formato ora SMPTE 30 drop
  • formato ora tmsf
  • contatore della modalità temporale
  • rilevamento della modalità temporale
  • time mode timecode
  • rilevamento più
  • meno rilevamento
  • ripristino del rilevamento
videodisc
  • audio tutto disattivato
  • audio tutto acceso
  • audio interrotto
  • audio a sinistra
  • audio immediatamente disattivato
  • audio direttamente su
  • porta chiusa
  • porta aperta
  • fotogrammi di formato ora
  • formato ora hms
  • formato ora millisecondi
  • Traccia formato ora
  • video disattivato
  • video su
Waveaudio
  • integer di allineamento
  • qualsiasi input
  • qualsiasi output
  • audio tutto disattivato
  • audio tutto acceso
  • audio interrotto
  • audio a sinistra
  • audio immediatamente disattivato
  • audio direttamente su
  • bitspersample bit_count
  • bytepersec byte_rate
  • canali channel_count
  • porta chiusa
  • porta aperta
  • format tag pcm
  • tag di formato
  • numero intero di input
  • output integer
  • samplespersec integer
  • byte di formato ora
  • formato ora millisecondi
  • esempi di formato ora

Nella tabella seguente sono elencati i flag che possono essere specificati nel parametro lpszSetting e i relativi significati.

Valore Significato
integer di allineamento Imposta l'allineamento dei blocchi di dati rispetto all'inizio dei dati passati al dispositivo audio waveform. Il file viene salvato in questo formato.
qualsiasi input Usare qualsiasi input che supporti il formato corrente durante la registrazione. Si tratta dell'impostazione predefinita.
qualsiasi output Usare qualsiasi output che supporti il formato corrente durante la riproduzione. Questo è il valore predefinito.
assemblare record su
assemblare record off
In modalità assemblaggio, tutte le tracce vengono registrate come definito dal dispositivo. Per impostazione predefinita, la maggior parte delle vcr è in modalità assemblaggio.
audio tutto disattivato
audio tutto acceso
Disabilita o abilita l'output audio. I dispositivi di sovrimpressione video, MCISEQ Sequencer e il dispositivo mcIWAVE waveform-audio non supportano questo flag.
audio interrotto
audio a sinistra
audio immediatamente disattivato
audio direttamente su
Disabilita o abilita l'output a sinistra o al canale audio destro. I dispositivi di sovrimpressione video, MCISEQ Sequencer e il dispositivo mcIWAVE waveform-audio non supportano questo flag.
bitspersample bit_count Imposta il numero di bit per campione PCM (Pulse Code Modulation) riprodotto o registrato. Il file viene salvato in questo formato.
bytepersec byte_rate Imposta il numero medio di byte al secondo riprodotto o registrato. Il file viene salvato in questo formato.
canali channel_count Imposta i canali per la riproduzione e la registrazione. Il file viene salvato in questo formato.
ora dell'orologio Imposta l'ora sull'orologio esterno su ora. Il formato viene specificato come intero senza segno lungo.
formato contatore Impostare il formato di ora per il contatore, come restituito dal " contatore". Per informazioni sui tipi applicabili, vedere il comando "formato ora" impostato .
valore del contatore Imposta il contatore del registro virtuale sul valore specificato. Il valore deve essere specificato nel formato contatore corrente. Per altre informazioni, vedere il comando set "counter format".
porta chiusa Ritira il vassoio e chiude la porta, se possibile. Per i vcr, carica automaticamente il nastro.
porte aperte Apre la porta ed esegge il nastro o il vassoio, se possibile.
formato file Specifica un formato di file utilizzato 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. I formati di file seguenti sono definiti:
  • avi: specifica il formato AVI.
  • avss: specifica il formato AVSS.
  • dib: specifica il formato DIB.
  • jfif: specifica il formato JFIF.
  • jpeg: specifica il formato JPEG.
  • mpeg: specifica il formato MPEG.
  • rdib: specifica il formato DIB RLE.
  • rjpeg: specifica il formato RJPEG.
formato tag pcm Imposta il tipo di formato su PCM per la riproduzione e la registrazione. Il file viene salvato in questo formato.
tag di formato Imposta il tipo di formato per la riproduzione e la registrazione. Il file viene salvato in questo formato.
timecode di indice
contatore indice
data di indice
tempo di indice
Imposta la schermata di visualizzazione corrente nel registro virtuale.
intero di input Imposta il canale audio usato come input.
durata della lunghezza Imposta la lunghezza specificata dall'utente del nastro nel registro virtuale. Questa lunghezza viene restituita dal comando stato "length" e viene fornita per la compatibilità con le applicazioni che richiedono che questo comando restituisca una lunghezza valida.
master midi Imposta il sequencer MIDI come origine di sincronizzazione. I dati di sincronizzazione vengono inviati in formato MIDI. Il sequencer MCISEQ non supporta questo flag.
master none Impedisce al sequencer MIDI di inviare dati di sincronizzazione. Il sequencer MCISEQ non supporta questo flag.
smpte master Imposta il sequencer MIDI come origine di sincronizzazione. I dati di sincronizzazione vengono inviati in formato SMPTE (Society of Motion Picture and Television Engineers). Il sequencer MCISEQ non supporta questo flag.
tempo di offset Imposta il tempo di offset SMPTE. L'offset è l'ora iniziale di una sequenza basata su SMPTE. Il tempo viene espresso come hh: mm: ss: ff, dovehh è ore, mm è minuti, ss è secondi e ff è frame.
integer di output Imposta il canale audio usato come output.
timeout di sospensione Imposta la durata massima, in millisecondi, di un comando di sospensione . Un valore di timeout pari a zero indica che non si verificherà alcun timeout .
durata postroll duration Imposta la lunghezza, nel formato di tempo corrente, necessaria per frenare il trasporto VCR quando viene rilasciato un comando di arresto o sospensione .
mapper di porta Imposta il mapper MIDI come porta che riceve i messaggi MIDI. Questo comando ha esito negativo se il mapper MIDI o una porta necessaria viene usato da un'altra applicazione.
porta none Disabilita l'invio di messaggi MIDI. Questo comando chiude anche una porta MIDI.
porta port_number Imposta la porta MIDI che riceve i messaggi MIDI. Questo comando ha esito negativo se la porta che si sta tentando di aprire viene usata da un'altra applicazione.
alimentazione
disattivare l'alimentazione
Imposta l'alimentazione del dispositivo su attiva o disattivata.
durata della registrazione preliminare Imposta la lunghezza, nel formato ora corrente, necessaria per stabilizzare l'output del registro virtuale.
formato record SP
formato record LP
EP in formato record
Imposta la modalità di registrazione per il VCR su SP per la riproduzione standard, l'EP per la riproduzione estesa o LP per la riproduzione prolungata. Questi valori non devono essere specifici di VHS. Vengono mappati a tre modalità appropriate con altri formati di nastro. Ad esempio, SP esegue il mapping alla registrazione di qualità più veloce e più veloce.
integer samplespersec Imposta la frequenza di esempio per la riproduzione e la registrazione. Il file viene salvato in questo formato.
cercare esattamente su
cercare esattamente fuori
Seleziona una delle due modalità di ricerca. Con "cerca esattamente su", la ricerca si sposta sempre nel frame specificato. Con "cerca esattamente fuori", la ricerca passa al fotogramma chiave più vicino prima del frame specificato.
file slave Imposta il sequencer MIDI per utilizzare i dati dei file come origine di sincronizzazione. Si tratta dell'impostazione predefinita.
slave midi Imposta il sequencer MIDI per utilizzare i dati MIDI in ingresso per l'origine di sincronizzazione. Sequencer riconosce i dati di sincronizzazione con il formato MIDI. Il sequencer MCISEQ non supporta questo flag.
slave none Imposta il sequencer MIDI per ignorare la sincronizzazione
slave smpte Imposta il sequencer MIDI per utilizzare i dati MIDI in ingresso per l'origine di sincronizzazione. Sequencer riconosce i dati di sincronizzazione con il formato SMPTE. Il sequencer MCISEQ non supporta questo flag.
fattore di velocità Imposta la velocità relativa della riproduzione di video e audio dall'area di lavoro. Il fattore è il rapporto tra la frequenza dei fotogrammi nominale e la frequenza dei fotogrammi desiderata, in cui la frequenza dei fotogrammi nominale è designata come 1000. (Una velocità di 500 è la metà della velocità normale, 2000 è due volte normale velocità e così via). L'impostazione della velocità su zero riproduce il video il più velocemente possibile senza rilasciare fotogrammi e senza audio.
formato di file ancora Specifica il formato di file utilizzato per i comandi di acquisizione.
tempo tempo_value Imposta il tempo della sequenza in base al formato dell'ora corrente. Per un file basato su PPQN, il tempo_value viene interpretato come battiti al minuto. Per un file basato su SMPTE, il tempo_value viene interpretato come frame al secondo.
byte di formato ora In un formato di file PCM, imposta il formato ora su byte. Tutte le informazioni sulla posizione vengono specificate come byte dopo questo comando.
fotogrammi di formato ora Imposta il formato dell'ora su frame. Tutti i comandi che usano valori di posizione presuppongono frame. Quando il dispositivo viene aperto, i frame sono la modalità predefinita. Supportato da videodiscs con il formato CAV.
formato ora hms Imposta il formato dell'ora su ore, minuti e secondi. Tutti i comandi che usano valori di posizione presuppongono HMS. HMS è il formato predefinito per gli individuazione video CLV. Specificare un valore HMS come hh:mm:ss, dove hh è ore, mm è minuti e ss è secondi. È possibile omettere un campo se è uguale a zero e tutti i campi seguenti sono zero. Ad esempio, 3, 3:0 e 3:0:0 sono tutti modi validi per esprimere 3 ore.
formato ora millisecondi Imposta il formato dell'ora su millisecondi. Tutti i comandi che usano valori di posizione presuppongono millisecondi. È possibile abbreviare i millisecondi come "ms". Per i dispositivi sequencer, il file di sequenza imposta il formato predefinito su PPQN o SMPTE. I dispositivi di sovrapposizione video non supportano questo flag.
formato ora msf Imposta il formato dell'ora su minuti, secondi e fotogrammi. Tutti i comandi che usano valori di posizione presuppongono MSF (il formato predefinito per l'audio CD). Specificare un valore MSF come mm:ss:ff, dove mm è minuti, ss è secondi e ff è frame. È possibile omettere un campo se è uguale a zero e tutti i campi seguenti sono zero. Ad esempio, 3, 3:0 e 3:0:0 sono modi validi per esprimere 3 minuti.
I campi MSF hanno i valori massimi seguenti:
  • Minuti 99
  • Secondi 59
  • Frame 74
esempi di formato ora Imposta il formato dell'ora su campioni. Tutte le informazioni sulla posizione vengono specificate come esempi dopo questo comando.
formato ora smpte 24
formato ora smpte 25
formato ora smpte 30
Imposta il formato dell'ora su una frequenza dei fotogrammi SMPTE. Per le richieste di recapito, imposta il formato ora su hh:mm:ss:ff, dove i valori legali sono da 00:00:00:00 a 23:59:59:xx e xx è minore dei fotogrammi al secondo come specificato dal numero 24, 25 o 30 come specificato nel flag. All'input, due punti (:) sono necessari per separare i componenti. Le unità meno significative possono essere omesse se sono 00; Ad esempio, 02:00 è uguale a 02:00:00:00. Tutti i comandi che usano valori di posizione presuppongono il formato SMPTE.
Il file di sequenza imposta il formato predefinito su PPQN o SMPTE.
formato ora smpte 30 drop Imposta il formato ora su SMPTE 30 drop frame rate. Per le vcr, come SMPTE 30, ad eccezione del fatto che determinate posizioni di timecode vengono eliminate dal formato in modo da avere le posizioni del timecode registrate per ogni fotogramma (alla frequenza dei fotogrammi NTSC di 29,97 fps) corrispondono a tempo reale (a 30 fps). Le posizioni timecode eliminate sono le seguenti: due ogni minuto, al minuto, per i primi nove di ogni dieci minuti di contenuto registrato. Ad esempio, alle 01:04:59:29, la posizione timecode successiva sarà 01:05:00:02, non 01:05:00:00. Tutti i comandi che usano valori di posizione presuppongono il formato SMPTE.
Il file di sequenza imposta il formato predefinito su PPQN o SMPTE.
puntatore del brano in formato ora Imposta il formato dell'ora sul puntatore del brano (sedicesima nota). Tutti i comandi che usano i valori di posizione presuppongono unità di misura del puntatore del brano. Questo flag è valido solo per una sequenza di tipi di divisione PPQN.
formato ora tmsf Imposta il formato dell'ora su tracce, minuti, secondi e fotogrammi. Tutti i comandi che usano valori di posizione presuppongono TMSF. Specificare un valore TMSF come tt:mm:ss:ff, dove tt è tracce, mm è minuti, ss è secondi e ff è frame. È possibile omettere un campo se è uguale a zero e tutti i campi seguenti sono zero. Ad esempio, 3, 3:0, 3:0:0 e 3:0:0:0 sono tutti modi validi per esprimere la traccia 3.
I campi TMSF hanno i valori massimi seguenti:
  • Tracce 99
  • Minuti 90
  • Secondi 59
  • Frame 74
Traccia formato ora Imposta il formato della posizione su tracce. Tutti i comandi che usano valori di posizione presuppongono tracce.
contatore della modalità temporale Imposta la modalità di informazioni sulla posizione per l'uso dei contatori VCR.
rilevamento della modalità temporale Imposta la modalità informazioni sulla posizione in base al rilevamento delle informazioni sul codice temporale sul nastro. Se vengono rilevate informazioni sul timecode, il tipo di ora viene impostato su "timecode"; in caso contrario, il tipo di ora è impostato su "contatore". "Detect" è una modalità speciale. Ogni volta che il driver viene aperto, viene inserito un nuovo nastro o viene eseguito il comando "time mode", il driver controlla la modalità temporale corrente disponibile sul nastro e imposta "time type" su "timecode" o "counter". Una volta impostato il tipo di ora, il driver non lo modifica fino a quando non si verifica nuovamente una delle condizioni precedenti.
time mode timecode Imposta la modalità informazioni sulla posizione per usare le informazioni "timecode" sul nastro.
rilevamento più
rilevamento meno
rilevamento reimpostazione
Regola la velocità del trasporto videotape in incrementi di fine. Usare i flag di "rilevamento" quando viene ottenuta un'immagine rumorosa da un registro virtuale. "Rilevamento più" aumenta la velocità di trasporto. "Rilevamento meno" riduce la velocità di trasporto. "Rilevamento reimpostazione" restituisce la regolazione del rilevamento su zero.
video disattivato Disabilita l'output video.
video su Abilita l'output video.

lpszFlags

Può essere "wait", "notify" o entrambi. Per i dispositivi digital-video e VCR, è anche possibile specificare "test". Per altre informazioni su questi flag, vedere Attesa, notifica e flag di test.

Valore restituito

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

Commenti

Diverse proprietà dei dati waveform-audio vengono definite quando viene creato il file per archiviare i dati. 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 identifica queste proprietà:

  • allineamento
  • bitspersample
  • bytepersec
  • channels
  • tag di formato
  • samplespersec

Esempio

Il comando seguente imposta il formato ora su millisecondi e imposta il formato waveform-audio su 8 bit, mono, 11 kHz.

set mysound time format ms bitspersample 8 channels 1 samplespersec 11025

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]

Vedi anche

MCI

Stringhe di comando MCI

Catturare

pause

salvataggio

stop