Macro e messaggi di funzioni MCI

La maggior parte delle applicazioni MCI usa le funzioni mciSendString e mciSendCommand dozzine di volte. MCI fornisce altre funzioni utili che l'applicazione utilizzerà con minore frequenza.

L'identificatore del dispositivo richiesto dalla maggior parte dei comandi MCI viene in genere recuperato in una chiamata al comando Open (MCI _ Open). Se è necessario un identificatore di dispositivo ma non si vuole aprire il dispositivo, ad esempio se si vuole eseguire una query sulle funzionalità del dispositivo prima di eseguire qualsiasi altra azione, è possibile chiamare la funzione mciGetDeviceID .

La funzione mciGetCreatorTask consente all'applicazione di usare un identificatore di dispositivo per recuperare un handle per l'attività che ha creato tale identificatore.

È possibile utilizzare le funzioni mciGetYieldProc e mciSetYieldProc per assegnare e recuperare l'indirizzo della funzione di callback associata al flag di attesa (MCI _ Wait).

La funzione mciGetErrorString recupera una stringa che descrive un valore di errore MCI. Ogni stringa restituita da MCI, che indica se i dati o una descrizione dell'errore, sono costituiti da un massimo di 128 caratteri. I campi della finestra di dialogo di dimensioni inferiori a 128 caratteri troncano le stringhe più lunghe restituite da MCI. Per ulteriori informazioni su queste stringhe, vedere MCIERR return values.

Le macro MCI sono strumenti che è possibile usare per creare e disassemblare valori che specificano i formati di ora. Questi formati di ora vengono usati in molti comandi MCI. I formati utilizzati dalle macro sono ore/minuti/secondi (HMS), minuti/secondi/frame (MSF) e tracce/minuti/secondi/frame (TMSF). Nella tabella seguente sono elencate le macro e le relative descrizioni.

Macro Descrizione
ora di MCI _ _ Recupera il componente ore da un valore HMS.
_minuto dell'ottavo MCI _ Recupera il componente minuti da un valore HMS.
_secondo MCI _ Recupera il componente secondi da un valore HMS.
MCI _ make _ HMS Crea un valore HMS.
MCI _ make _ MSF Crea un valore MSF.
MCI _ make _ TMSF Crea un valore TMSF.
_frame MSF di MCI _ Recupera il componente frame da un valore MSF.
_minuto MSF di MCI _ Recupera il componente minuti da un valore MSF.
_secondo MSF di MCI _ Recupera il componente secondi da un valore MSF.
_frame TMSF _ MCI Recupera il componente frames da un valore TMSF.
_TMSF _ minuto MCI Recupera il componente minuti da un valore TMSF.
_secondo TMSF _ MCI Recupera il componente secondi da un valore TMSF.
_traccia TMSF _ MCI Recupera il componente Tracks da un valore TMSF.

 

MCI fornisce anche due messaggi: mm _ MCINOTIFY e mm _ MCISIGNAL. Il _ messaggio mm MCINOTIFY notifica a un'applicazione il risultato di un comando MCI ogni volta che il comando specifica il flag di notifica (MCI _ Notify). Il _ messaggio MCISIGNAL mm è specifico per i dispositivi video digitali. Invia una notifica all'applicazione quando viene raggiunta una posizione specificata.