comando di stato
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
);
-
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.
Restituisce informazioni nel parametro lpszReturnString di mciSendString. Le informazioni dipendono dal tipo di richiesta.
Prima di eseguire tutti i comandi che usano valori di posizione, è necessario impostare il formato dell'ora desiderato usando il comando set .
Il comando seguente restituisce la modalità corrente del dispositivo "mysound".
status mysound mode
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |