comando di funzionalità
Il comando di funzionalità richiede informazioni su una particolare funzionalità di un dispositivo. Tutti i dispositivi MCI 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("capability %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 che identifica una funzionalità del dispositivo. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando di funzionalità e i flag usati da ogni tipo:
Valore Tipo Tipo cdaudio - può esettare
- può giocare
- può registrare
- può salvare
- dispositivo composto
- tipo di dispositivo
- ha audio
- ha video
- usa i file
digitalvideo - può esettare
- può bloccarsi
- può bloccare
- può giocare
- può registrare
- può invertire
- può salvare
- può estendersi
- può estendere l'input
- può testare
- dispositivo composto
- tipo di dispositivo
- ha audio
- ha ancora
- ha video
- velocità massima di riproduzione
- frequenza minima di riproduzione
- usa i file
- usa le tavolozze
- windows
overlay - può esettare
- può bloccarsi
- può giocare
- può registrare
- può salvare
- può estendersi
- dispositivo composto
- tipo di dispositivo
- ha audio
- ha video
- usa i file
- windows
sequencer - può esettare
- può giocare
- può registrare
- può salvare
- dispositivo composto
- tipo di dispositivo
- ha audio
- ha video
- usa i file
Vcr - può rilevare la lunghezza
- può esettare
- può bloccarsi
- può monitorare le origini
- può giocare
- può preroll
- può visualizzare l'anteprima
- può registrare
- può invertire
- può salvare
- può testare
- frequenza di incremento dell'orologio
- dispositivo composto
- tipo di dispositivo
- ha audio
- ha l'orologio
- ha timecode
- ha video
- numero di contrassegni
- ricerca accuratezza
- usa i file
videodisc - può esettare
- può giocare
- può registrare
- può invertire
- può salvare
- CAV
- CLV
- dispositivo composto
- tipo di dispositivo
- velocità di riproduzione rapida
- ha audio
- ha video
- frequenza di riproduzione normale
- velocità di riproduzione lenta
- usa i file
Waveaudio - può esettare
- può giocare
- può registrare
- può salvare
- dispositivo composto
- tipo di dispositivo
- ha audio
- ha video
- input
- outputs
- usa i file
La tabella seguente elenca i flag che possono essere specificati nel parametro lpszRequest e i relativi significati:
Flags Significato può rilevare la lunghezza Restituisce TRUE se il dispositivo può rilevare la lunghezza del supporto. può esettare Restituisce TRUE se il dispositivo può esettare il supporto. può bloccarsi Restituisce TRUE se il dispositivo può bloccare i dati nel buffer del frame. può bloccare Restituisce TRUE se il dispositivo può bloccare i dati. può monitorare le origini Restituisce TRUE se il dispositivo può passare un input (origine) all'output monitorato, indipendentemente dalla selezione di input corrente. può giocare Restituisce TRUE se il dispositivo può essere riprodotto. può preroll Restituisce TRUE se il dispositivo supporta il flag "preroll" con il comando cue . può visualizzare l'anteprima Restituisce TRUE se il dispositivo supporta le anteprime. può registrare Restituisce TRUE se il dispositivo supporta la registrazione. può invertire Restituisce TRUE se il dispositivo può essere riprodotto inverso. può salvare Restituisce TRUE se il dispositivo può salvare i dati. può estendersi Restituisce TRUE se il dispositivo può estendere i fotogrammi per riempire un determinato rettangolo di visualizzazione. può estendere l'input Restituisce TRUE se il dispositivo può ridimensionare un'immagine nel processo di digitalizzazione nel buffer dei fotogrammi. può testare Restituisce TRUE se il dispositivo riconosce la parola chiave di test. Cav Se combinato con altri elementi, questo flag specifica che le informazioni restituite si applicano ai contenuti video in formato CAV. Si tratta dell'impostazione predefinita se non viene inserito alcun elemento videodisc. frequenza di incremento dell'orologio Restituisce il numero di suddivisioni supportate dall'orologio esterno al secondo. Se l'orologio esterno è un orologio in millisecondo, il valore restituito è 1000. Se il valore restituito è 0, non è supportato alcun orologio. clv Se combinato con altri elementi, questo flag specifica che le informazioni restituite si applicano ai videodiscs in formato CLV. dispositivo composto Restituisce TRUE se il dispositivo supporta un nome di elemento (nome file). tipo di dispositivo Restituisce un nome del tipo di dispositivo, che può essere uno dei seguenti: - cdaudio
- Dat
- digitalvideo
- altro
- overlay
- scanner
- sequencer
- Vcr
- videodisc
- Waveaudio
velocità di riproduzione rapida Restituisce la velocità di riproduzione rapida nei fotogrammi al secondo o zero se il dispositivo non riesce a riprodurre rapidamente. ha audio Restituisce TRUE se il dispositivo supporta la riproduzione audio. ha l'orologio Restituisce TRUE se il dispositivo ha un orologio. ha ancora Restituisce TRUE se il dispositivo tratta i file con un'unica immagine in modo più efficiente rispetto ai file video di movimento. ha timecode Restituisce TRUE se il dispositivo è in grado di supportare il codice temporale o se è sconosciuto. ha video Restituisce TRUE se il dispositivo supporta il video. input Restituisce il numero totale di dispositivi di input. velocità massima di riproduzione Restituisce la frequenza di riproduzione massima, in fotogrammi al secondo, per il dispositivo. frequenza minima di riproduzione Restituisce la frequenza di riproduzione minima, in fotogrammi al secondo, per il dispositivo. frequenza di riproduzione normale Restituisce la frequenza di riproduzione normale, in fotogrammi al secondo, per il dispositivo. numero di contrassegni Restituisce il numero massimo di segni che possono essere usati; zero indica che i segni non sono supportati. outputs Restituisce il numero totale di dispositivi di output. accuratezza della ricerca Restituisce l'accuratezza prevista di una ricerca in fotogrammi; 0 indica che il dispositivo è accurato nel frame, 1 indica che il dispositivo prevede di trovarsi all'interno di un frame della posizione di ricerca indicata e così via. velocità di riproduzione lenta Restituisce la frequenza di riproduzione lenta nei fotogrammi al secondo o zero se il dispositivo non può essere riprodotto lentamente. usa i file Restituisce TRUE se l'archiviazione dei dati utilizzata da un dispositivo composto è un file. usa tavolozze Restituisce TRUE se il dispositivo utilizza tavolozze. windows Restituisce il numero di finestre di visualizzazione simultanee che il dispositivo può supportare. -
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 della funzione mciSendString . Le informazioni dipendono dal tipo di richiesta.
Esempio
Il comando seguente restituisce il tipo di dispositivo "mysound".
capability mysound device type
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |