funzione acmDriverMessage (msacm.h)
La funzione acmDriverMessage invia un messaggio definito dall'utente a un'istanza del driver ACM specificata.
Sintassi
LRESULT ACMAPI acmDriverMessage(
HACMDRIVER had,
UINT uMsg,
LPARAM lParam1,
LPARAM lParam2
);
Parametri
had
Gestire l'istanza del driver ACM a cui verrà inviato il messaggio.
uMsg
Messaggio che il driver ACM deve elaborare. Questo messaggio deve trovarsi nell'intervallo di messaggi ACMDM_USER (sopra o uguale a ACMDM_USER e minore di ACMDM_RESERVED_LOW). Le eccezioni a questa restrizione sono i messaggi ACMDM_DRIVER_ABOUT, DRV_QUERYCONFIGURE e DRV_CONFIGURE .
lParam1
Parametro del messaggio.
lParam2
Parametro del messaggio.
Valore restituito
Il valore restituito è specifico del messaggio del driver ACM definito dall'utente specificato dal parametro uMsg. Tuttavia, i valori di errore possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
L'handle specificato non è valido. |
|
Il parametro uMsg non si trova nell'intervallo di ACMDM_USER. |
|
Il driver ACM non ha elaborato il messaggio. |
Commenti
Per visualizzare una finestra di dialogo Informazioni personalizzata da un driver ACM, un'applicazione deve inviare il messaggio di ACMDM_DRIVER_ABOUT al driver. Il parametro lParam1 deve essere l'handle della finestra del proprietario per la finestra di dialogo Informazioni personalizzata e lParam2 deve essere impostato su zero. Se il driver non supporta una finestra di dialogo Informazioni personalizzate, MMSYSERR_NOTSUPPORTED verrà restituito ed è responsabilità dell'applicazione visualizzare la propria finestra di dialogo. Ad esempio, l'opzione Pannello di controllo Sound Mapper visualizzerà una finestra di dialogo About predefinita in base alla struttura ACMDRIVERDETAILS quando un driver ACM restituisce MMSYSERR_NOTSUPPORTED. Un'applicazione può eseguire query su un driver per il supporto della finestra di dialogo Informazioni personalizzate senza visualizzare la finestra di dialogo impostando lParam1 su -1L. Se il driver supporta una finestra di dialogo Informazioni personalizzate, MMSYSERR_NOERROR verrà restituito. In caso contrario, il valore restituito è MMSYSERR_NOTSUPPORTED.
I messaggi definiti dall'utente devono essere inviati solo a un driver ACM che supporta in modo specifico i messaggi. Il chiamante deve verificare che il driver ACM sia il driver corretto recuperando i dettagli del driver e controllando i membri wMid, wPid e vdwDriver della struttura ACMDRIVERDETAILS .
Non inviare mai messaggi definiti dall'utente a un driver ACM sconosciuto.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | msacm.h |
| Libreria | Msacm32.lib |
| DLL | Msacm32.dll |