comando di stato

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 di stato richiede informazioni sullo stato da un dispositivo. Tutti i dispositivi 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("status %s %s %s"),
  lpszDeviceID,
  lpszRequest,
  lpszFlags
);

Parametri

lpszDeviceID

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

lpszRequest

Contrassegno per la richiesta di informazioni sullo stato. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando di stato e i flag usati da ogni tipo.

Tipo di dispositivo	Flag di richiesta
cdaudio	numero di traccia del tipo cdaudio traccia corrente length numero di traccia di lunghezza media presente mode numero di tracce position numero di traccia posizione Pronto posizione iniziale formato dell'ora
digitalvideo	Audio allineamento audio bit audiospersample interruzioni audio byte audiopersec input audio record audio origine audio esempi audiopersec flusso audio Basso bitsperpel luminosità color elevato traccia corrente unità spazio su disco completamento file formato file modalità file forward fotogrammi ignorati gamma input volume sinistro length numero di traccia di lunghezza media presente mode monitoraggio metodo di monitoraggio Nominale frequenza dei fotogrammi nominale frequenza dei fotogrammi dei record nominale numero di tracce output handle della tavolozza modalità di sospensione velocità di riproduzione position numero di traccia posizione Pronto frequenza dei fotogrammi record frame di riferimento dimensioni riservate volume destro cercare esattamente Nitidezza Smpte velocità posizione iniziale formato di file ancora formato dell'ora Tinta Alti non salvato Video indice della chiave video colore chiave video record video origine video numero di origine video flusso video volume handle di finestra finestra visibile finestra ridotta a icona finestra ingrandita
overlay	file multimediali presenti mode numero di tracce Pronto adattamento handle di finestra
sequencer	traccia corrente tipo di divisione length length track number master file multimediali presenti mode numero di tracce offset port position numero di traccia posizione Pronto Schiavo posizione iniziale tempo formato dell'ora
Vcr	assemblare record monitor audio numero di monitoraggio audio record audio numero di traccia del record audio origine audio numero di origine audio channel numero di tuner del canale clock clock id counter formato contatore risoluzione dei contatori traccia corrente frequenza dei fotogrammi index indice su length numero di traccia lunghezza file multimediali presenti tipo di supporto mode numero di tracce audio numero di tracce numero di tracce video timeout pausa formato di riproduzione position inizio posizione numero di traccia posizione durata postroll accensione durata preroll Pronto formato record velocità formato dell'ora modalità ora tipo di ora timecode presente record timecode tipo timecode numero di tuner monitor video numero di monitoraggio video registrazione video video record track number origine video numero di origine video scrittura protetta
videodisc	traccia corrente dimensioni del disco forward length numero di traccia lunghezza file multimediali presenti tipo di supporto mode numero di tracce position numero di traccia posizione Pronto Lato velocità posizione iniziale formato dell'ora
Waveaudio	allineamento bitspersample bytepersec channels traccia corrente tag di formato input length numero di traccia di lunghezza livello media presente mode numero di tracce output position numero di traccia posizione Pronto samplespersec posizione iniziale formato dell'ora

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

Valore	Significato
allineamento	Restituisce l'allineamento dei blocchi dei dati, in byte.
assemblare record	Restituisce TRUE se il dispositivo è impostato per assemblare la registrazione in modalità.
Audio	Restituisce "on" o "off" a seconda del comando setaudio "on" o "off" più recente. Restituisce "on" se entrambi gli altoparlanti sono abilitati e "disattivati" in caso contrario.
allineamento audio	Restituisce l'allineamento dei blocchi di dati rispetto all'inizio dei dati waveform-audio di input.
bit audiospersample	Restituisce il numero di bit per esempio usati dal dispositivo per la registrazione. Questo flag si applica solo ai dispositivi che supportano l'algoritmo "pcm".
interruzioni audio	Restituisce il numero di volte in cui la parte audio dell'ultima sequenza AVI è stata interrotta. Il sistema conta un'interruzione audio ogni volta che tenta di scrivere dati audio nel driver del dispositivo e individua che il driver ha già riprodotto tutti i dati disponibili. Questo flag viene riconosciuto solo dal driver digitale-video MCIAVI. È destinato solo alla valutazione delle prestazioni; il valore restituito è difficile da interpretare.
byte audiopersec	Restituisce il numero medio di byte al secondo utilizzato per la registrazione.
input audio	Restituisce il livello audio istantaneo approssimativo del segnale audio di input analogico. Un valore maggiore di 1000 implica la distorsione di ritaglio. Alcuni dispositivi possono restituire questo valore solo durante la registrazione dell'audio. Il valore non ha alcun comando set o setaudio associato.
monitoraggio audio	Restituisce "output" o uno dei tipi di input di origine validi. Per altre informazioni, vedere il comando setaudio "monitor".
numero di monitoraggio audio	Restituisce il numero di video monitorato del tipo specificato dallo stato "monitoraggio audio". Per altre informazioni, vedere il comando setaudio .
record audio	Restituisce "on" o "off", che riflette lo stato impostato da setaudio "record".
numero di traccia del record audio	Restituisce TRUE se il registro virtuale è impostato per registrare l'audio. Se non viene specificato alcun numero di traccia, viene assunto il valore predefinito 1.
esempi audiopersec	Restituisce il numero di campioni al secondo registrati.
origine audio	Restituisce l'origine del digitalizzatore audio corrente: "left", "right", "average" o "stereo".
numero di origine audio	Restituisce il numero di origine audio del tipo restituito dallo stato "origine audio". Per altre informazioni, vedere il comando setaudio .
flusso audio	Restituisce il numero di flusso audio corrente.
Basso	Restituisce il livello audio-basso corrente.
bitsperpel	Restituisce il numero di bit per pixel per il salvataggio di dati acquisiti o registrati.
bitspersample	Restituisce i bit per esempio.
luminosità	Restituisce il livello di luminosità video corrente.
bytepersec	Restituisce il numero medio di byte al secondo riprodotto o registrato.
numero di traccia del tipo cdaudio	Restituisce il tipo del numero di traccia specificato. Questo può essere "audio" o "altro".
channel	Restituisce il valore intero del canale impostato sul tuner.
numero di tuner del canale	Se viene specificato il numero di "tuner", verrà restituito il canale attualmente selezionato nel numero di tuner logico. Si noti che è possibile usare diversi tuner logici.
channels	Restituisce il numero di canali impostati (1 per mono, 2 per stereo).
clock	Restituisce l'ora esterna. Il tempo deve essere un intero lungo senza segno che esprime incrementi totali. Per altre informazioni, vedere il comando "frequenza di incremento dell'orologio".
ID orologio	Restituisce un intero univoco che identifica l'orologio.
color	Restituisce il livello di colore corrente.
elevato	Restituisce il livello di contrasto corrente.
counter	Restituisce la posizione del contatore, nel formato contatore corrente.
formato contatore	Restituisce il formato del contatore corrente. Per altre informazioni, vedere il comando set "counter format".
risoluzione dei contatori	Restituisce "frame" o "secondi", che indica la risoluzione del contatore. Questo non equivale all'accuratezza.
traccia corrente	Restituisce la traccia corrente. Il sequencer MCISEQ restituisce 1.
dimensioni del disco	Restituisce 8 o 12, che indica le dimensioni del disco caricato in pollici.
unità spazio su disco	Restituisce lo spazio su disco approssimativo, nel formato ora corrente, che può essere ottenuto da un comando di riserva per l'unità disco specificata .L'unità viene in genere specificata come una singola lettera o una singola lettera seguita da due punti (:). Alcuni dispositivi, tuttavia, potrebbero usare un percorso.
tipo di divisione	Restituisce uno dei tipi di divisione di file seguenti: PPQN Frame SMPTE 24 Frame SMPTE 25 Frame di rilascio SMPTE 30 Frame SMPTE 30 Utilizzare queste informazioni per determinare il formato del file MIDI e il significato delle informazioni sul tempo e sulla posizione.
completamento file	Restituisce la percentuale stimata di un'operazione di caricamento, salvataggio, acquisizione, taglio, copia, eliminazione, incolla o annullamento . Le applicazioni possono usarlo per fornire un indicatore visivo dello stato di avanzamento.
formato file	Restituisce il formato di file corrente per i comandi di record o salvataggio .
modalità file	Restituisce "loading", "saving", "editing" o "idle". Durante un'operazione di caricamento , restituisce "caricamento". Durante le operazioni di salvataggio e acquisizione , restituisce "salvataggio". Durante le operazioni taglia, copia, eliminazione, incolla o annullamento , restituisce "modifica".
tag di formato	Restituisce il tag di formato.
forward	Restituisce TRUE se la direzione di riproduzione è in avanti o se il dispositivo non è in riproduzione.
frequenza dei fotogrammi	Restituisce il numero di fotogrammi al secondo che il dispositivo userà per impostazione predefinita. I dispositivi NTSC restituiscono 30, PAL 25 e così via.
frame ignorati	Restituisce il numero di fotogrammi che non sono stati disegnati quando è stata riprodotta l'ultima sequenza AVI. Questo flag viene riconosciuto solo dal driver MCIAVI digital-video. È destinato solo alla valutazione delle prestazioni; il valore restituito è difficile da interpretare.
gamma	Restituisce il valore impostato con il valoresetvideo "gamma a".
index	Restituisce la visualizzazione dell'indice corrente. Per altre informazioni, vedere il comando set "index".
indice su	Restituisce TRUE se l'indice è attivato.
input	Restituisce il set di input. Se non è impostato, l'errore restituito indica che è possibile usare qualsiasi dispositivo. Per i dispositivi digital-video, modifica il flag "bass", "treble", "volume", "brightness", "color", "contrast", "gamma", "sharpness" o "tint" in modo che si applichi solo all'input. Si tratta dell'impostazione predefinita durante il monitoraggio dell'input.
volume sinistro	Restituisce il volume impostato per il canale audio sinistro.
length	Restituisce la lunghezza totale del supporto, nel formato dell'ora corrente. Per i file PPQN, la lunghezza viene restituita nelle unità puntatore del brano. Per i file SMPTE, viene restituito come hh:mm:ss:ff, dove hh è ore, mm è minuti, ss è secondi e ff è frame. Per i dispositivi VCR, la lunghezza è di 2 ore (a meno che la lunghezza non sia stata modificata in modo esplicito usando il comando set ).
numero di traccia lunghezza	Restituisce la lunghezza della traccia, in intervalli di tempo o fotogrammi, specificata in base al numero. Per i file PPQN, la lunghezza viene restituita nelle unità puntatore del brano. Per i file SMPTE, viene restituito come hh:mm:ss:ff, dove hh è ore, mm è minuti, ss è secondi e ff è frame.
livello	Restituisce il valore di esempio audio PCM corrente.
master	Restituisce "midi", "none" o "smpte" a seconda del tipo di set di sincronizzazione.
file multimediali presenti	Restituisce TRUE se il supporto viene inserito nel dispositivo o FALSE in caso contrario. I dispositivi sequencer, video overlay, digital-video e waveform-audio restituiscono TRUE.
tipo di supporto	Restituisce il tipo del supporto. Per VCRS, si tratta di "8mm", "vhs", "svhs", "beta", "Hi8", "edbeta" o "other". Per i videodiscs, si tratta di "CAV", "CLV" o "altro", a seconda del tipo di videodisc.
mode	Restituisce la modalità corrente del dispositivo. Tutti i dispositivi possono restituire i valori "not ready", "paused", "playing" e "stopped". Alcuni dispositivi possono restituire i valori aggiuntivi "open", "parked", "recording" e "seeking".
monitoraggio	Restituisce "file" o "input". Il valore restituito indica l'origine della presentazione corrente.
metodo monitor	Restituisce "pre", "post" o "direct". Il valore restituito indica il metodo usato per il monitoraggio dell'input.
Nominale	L'elemento modifica i flag "bass", "brightness", "color", "contrast", "gamma", "sharpness", "tint", "treble" e "volume" per restituire il valore nominale anziché l'impostazione corrente.
frequenza dei fotogrammi nominale	Restituisce la frequenza dei fotogrammi nominale associata al file. Le unità sono in fotogrammi al secondo moltiplicate per 1000.
frequenza dei fotogrammi dei record nominale	Restituisce la frequenza dei fotogrammi nominale associata al segnale video di input. Le unità sono in fotogrammi al secondo moltiplicate per 1000.
numero di tracce audio	Restituisce il numero di tracce audio nel supporto.
numero di tracce	Restituisce il numero di tracce nel supporto. I dispositivi MCISEQ e MCIWAVE restituiscono 1, come la maggior parte dei dispositivi VCR. Il dispositivo MCIPIONR non supporta questo flag.
numero di tracce video	Restituisce il numero di tracce video nel supporto.
offset	Restituisce l'offset di un file basato su SMPTE. L'offset è l'ora di inizio di una sequenza basata su SMPTE. L'ora viene restituita come hh:mm:ss:ff, dove hh è ore, mm è minuti, ss è secondi e ff è frame.
output	Restituisce l'output attualmente impostato. Se non è impostato alcun output, l'errore restituito indica che è possibile usare qualsiasi dispositivo. Per i dispositivi digital-video, modifica il flag "bass", "treble", "volume", "brightness", "color", "contrast", "gamma", "sharpness" o "tint" in modo che si applichi solo all'output. Si tratta dell'impostazione predefinita durante il monitoraggio di un file.
modalità di sospensione	Restituisce "registrazione" se il dispositivo viene sospeso durante la registrazione. Restituisce "riproduzione" se il dispositivo viene sospeso durante la riproduzione. Restituisce l'errore "Azione non applicabile in modalità corrente" se il dispositivo non è sospeso.
timeout pausa	Restituisce la durata massima, in millisecondi, di un comando di sospensione .
formato di riproduzione	Restituisce un codice che indica il formato in cui verrà riprodotta la videotape, se rilevabile: "lp", "ep", "sp" o "other". Per altre informazioni, vedere il flag "formato record".
velocità di riproduzione	Restituisce un valore che rappresenta il tempo di riproduzione effettivo dell'ultima sequenza AVI corrispondente al tempo di riproduzione di destinazione. Il valore 1000 indica che l'ora di destinazione e l'ora effettiva sono uguali. Il valore 2000, ad esempio, indica che la sequenza AVI ha richiesto il doppio del tempo necessario per la riproduzione. Questo flag viene riconosciuto solo dal driver MCIAVI digital-video. È destinato solo alla valutazione delle prestazioni; il valore restituito è difficile da interpretare.
port	Restituisce il numero di porta MIDI assegnato alla sequenza.
position	Restituisce la posizione corrente. Per i file PPQN, la posizione viene restituita nelle unità puntatore del brano. Per i file SMPTE, viene restituito come hh:mm:ss:ff, dove hh è ore, mm è minuti, ss è secondi e ff è frame.
inizio posizione	Restituisce la posizione dell'inizio del supporto utilizzabile.
numero di traccia posizione	Restituisce la posizione dell'inizio della traccia specificata in base al numero. Per i file PPQN, il formato dell'ora viene restituito nelle unità puntatore del brano. Per i file SMPTE, viene restituito come hh:mm:ss:ff, dove hh è ore, mm è minuti, ss è secondi e ff è frame. Il sequencer MCISEQ restituisce zero. Il dispositivo MCIPIONR non supporta questo flag. Il dispositivo MCIWAVE restituisce zero.
durata postroll	Restituisce la lunghezza del videotape, nel formato di ora corrente, necessaria per frenare il trasporto VCR quando viene eseguito un comando di arresto o pausa .
accensione	Restituisce TRUE se l'alimentazione del registro virtuale è attivata.
durata preroll	Restituisce la lunghezza del videotape, nel formato ora corrente, necessaria per stabilizzare l'output del record di controllo virtuale.
Pronto	Restituisce TRUE se il dispositivo è pronto per accettare un altro comando.
formato record	Restituisce un codice che indica il formato in cui verrà registrata la videotape. I tipi restituiti correnti sono "lp", "ep", "sp" o "other". Questi formati non sono specifici di VHS e possono essere applicati a qualsiasi registro virtuale con più formati di registrazione selezionabili. Il tipo "sp" è il formato di registrazione più veloce e di alta qualità e viene usato per impostazione predefinita in vcr in formato singolo.
frequenza dei fotogrammi record	Restituisce la frequenza dei fotogrammi, in fotogrammi al secondo moltiplicata per 1000, utilizzata per la compressione.
frame di riferimento	Restituisce il numero di fotogramma per l'immagine del fotogramma chiave più vicina che precede il frame specificato.
dimensioni riservate	Restituisce le dimensioni, nel formato ora corrente, dell'area di lavoro riservata. Le dimensioni corrispondono al tempo approssimativo necessario per riprodurre i dati compressi da un'area di lavoro completa. Restituisce zero se non è presente spazio su disco riservato. Questo flag restituisce le dimensioni approssimative perché lo spazio su disco preciso per i dati compressi non può, in generale, essere stimato fino a quando i dati sono stati compressi.
volume destro	Restituisce il volume impostato per il canale audio corretto.
samplespersec	Restituisce il numero di campioni al secondo riprodotti o registrati.
cercare esattamente	Restituisce "on" o "off", che indica se è impostato o meno il flag "seek exactly".
Nitidezza	Restituisce il livello di nitidezza corrente del dispositivo.
Lato	Restituisce 1 o 2 per indicare il lato del videodisco caricato.
Schiavo	Restituisce "file", "midi", "none" o "smpte" a seconda del tipo di set di sincronizzazione.
Smpte	Restituisce il codice temporale SMPTE associato alla posizione corrente nell'area di lavoro. Stringa con il formato dd:dd:dd:dd:dd, in cui ogni d indica una cifra da 0 a 9. Se i dati dell'area di lavoro non includono dati timecode, questo flag restituisce 00:00:00:00.
velocità	Restituisce la velocità corrente del dispositivo in fotogrammi al secondo (o nello stesso formato usato dal comando " speed" impostato). Il lettore di individuazione video MCIPIONR non supporta questo flag.
posizione iniziale	Restituisce la posizione iniziale del supporto.
formato di file ancora	Restituisce il formato di file corrente per il comando capture .
adattamento	Restituisce TRUE se l'estensione è abilitata.
tempo	Restituisce il tempo corrente di una sequenza MIDI nel formato ora corrente. Per i file con formato PPQN, il tempo è espresso in battute al minuto. Per i file con formato SMPTE, il tempo è espresso in fotogrammi al secondo.
formato dell'ora	Restituisce il formato dell'ora corrente. Per altre informazioni, vedere i formati temporali nel comando set .
modalità ora	Restituisce la modalità di tempo della posizione corrente. Può essere "detect", "timecode" o "counter".
tipo di ora	Restituisce il tempo di posizione corrente in uso: "timecode" o "counter".
timecode presente	Restituisce TRUE se timecode è stato registrato nella posizione corrente del nastro. Il timecode deve avanzare dalla posizione corrente. Potrebbe essere necessario riprodurre un record di controllo virtuale per controllare questa condizione.
record timecode	Restituisce TRUE se il registro virtuale è impostato su record timecode.
tipo timecode	Restituisce "smpte", "smpte drop", "other" o "none". Si noti che i fotogrammi al secondo possono essere ottenuti dal comando "frequenza dei fotogrammi" di stato e l'accuratezza del dispositivo può essere restituita dal comando "ricerca accuratezza".
Tinta	Restituisce il livello di tinta video corrente.
Alti	Restituisce il livello di treble audio corrente.
numero di tuner	Restituisce il numero corrente di tuner logico.
non salvato	Restituisce TRUE se nell'area di lavoro sono presenti dati registrati che potrebbero andare persi a causa di un comando close, load, record, reserve, cut, delete o paste . Restituisce FALSE in caso contrario.
Video	Restituisce "on" o "off", che riflette lo stato impostato dal comando setvideo .
colore chiave video	Restituisce il valore per il colore della chiave.
indice chiave video	Restituisce il valore per l'indice della chiave.
monitor video	Restituisce "output" o uno dei tipi di input di origine validi. Per altre informazioni, vedere il comando setvideo "monitor".
numero di monitoraggio video	Restituisce il numero di video monitorato del tipo restituito dallo stato "monitoraggio video". Per altre informazioni, vedere il comando setvideo .
registrazione video	Restituisce "on" o "off", che riflette lo stato corrente impostato da setvideo "record".
video record track number	Restituisce TRUE se il registro virtuale è impostato per registrare il video. Se non viene specificato alcun numero di traccia, viene utilizzato il valore predefinito 1.
origine video	Restituisce il tipo di origine video. Per altre informazioni, vedere il comando setvideo .
numero di origine video	Restituisce un numero corrispondente all'origine video del tipo in uso. Ad esempio, restituisce 2 se viene usato il secondo input di origine video NTSC.
flusso video	Restituisce il numero corrente del flusso video.
volume	Restituisce il volume medio all'altoparlante sinistro e destro. Viene restituito un errore se il dispositivo non è stato riprodotto o il volume non è stato impostato.
handle di finestra	Restituisce il valore decimale ASCII per l'handle di finestra nella parola in ordine basso del valore restituito.
finestra ingrandita	Restituisce TRUE se la finestra è ingrandita.
finestra ridotta a icona	Restituisce TRUE se la finestra è ridotta a icona.
finestra visibile	Restituisce TRUE se la finestra non è nascosta.
scrittura protetta	Restituisce TRUE se il dispositivo rileva che non è in grado di registrare , ovvero se la protezione di scrittura è attivata. Se può registrare o se non è in grado di determinare se può registrare (senza scrivere effettivamente), il driver restituisce FALSE.

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 Flag di attesa, notifica e test.

Valore restituito

Restituisce informazioni nel parametro lpszReturnString di mciSendString. Le informazioni dipendono dal tipo di richiesta.

Commenti

Prima di eseguire tutti i comandi che usano valori di posizione, è necessario impostare il formato dell'ora desiderato usando il comando set .

Esempio

Il comando seguente restituisce la modalità corrente del dispositivo "mysound".

status mysound mode

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
capability
Catturare
close
Tagliare
delete
carico
pause
Incollare
Registrazione
Riserva
salvataggio
set
setaudio
setvideo
stop
cancella

Condividi tramite