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
MMSYSERR_INVALHANDLE	L'handle specificato non è valido.
MMSYSERR_INVALPARAM	Il parametro uMsg non si trova nell'intervallo di ACMDM_USER.
MMSYSERR_NOTSUPPORTED	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

Vedi anche

Funzioni di compressione audio

Gestione compressione audio