Funzione acmDriverAdd (msacm.h)

Articolo
08/24/2023

La funzione acmDriverAdd aggiunge un driver all'elenco dei driver ACM disponibili. Il tipo di driver e la posizione dipendono dai flag usati per aggiungere driver ACM. Dopo l'aggiunta di un driver, la funzione di immissione del driver riceverà i messaggi del driver ACM.

Sintassi

MMRESULT ACMAPI acmDriverAdd(
  LPHACMDRIVERID phadid,
  HINSTANCE      hinstModule,
  LPARAM         lParam,
  DWORD          dwPriority,
  DWORD          fdwAdd
);

Parametri

phadid

Puntatore al buffer che riceve un handle che identifica il driver installato. Questo handle viene usato per identificare il driver nelle chiamate ad altre funzioni ACM.

hinstModule

Handle per l'istanza del modulo il cui file eseguibile o dll (Dynamic Link Library) contiene la funzione di immissione del driver.

lParam

Indirizzo della funzione driver o handle di finestra di notifica, a seconda dei flag fdwAdd .

dwPriority

Messaggio della finestra da inviare per le trasmissioni di notifica. Questo parametro viene usato solo con il flag ACM_DRIVERADDF_NOTIFYHWND. Tutti gli altri flag richiedono che questo membro sia impostato su zero.

fdwAdd

Flag per l'aggiunta di driver ACM. Vengono definiti i valori seguenti.

Valore	Significato
ACM_DRIVERADDF_FUNCTION	Il parametro lParam è un indirizzo della funzione driver conforme al prototipo acmDriverProc . La funzione può risiedere in un file eseguibile o DLL.
ACM_DRIVERADDF_GLOBAL	Fornito per la compatibilità con le applicazioni a 16 bit. Per l'API Win32, i driver ACM aggiunti dalla funzione acmDriverAdd possono essere usati solo dall'applicazione che ha aggiunto il driver. Ciò vale se è specificato o meno ACM_DRIVERADDF_GLOBAL. Per altre informazioni, vedere Aggiunta di driver all'interno di un'applicazione.
ACM_DRIVERADDF_LOCAL	ACM assegna automaticamente un driver locale con priorità più alta rispetto a un driver globale durante la ricerca di un driver per soddisfare una chiamata di funzione. Per altre informazioni, vedere Aggiunta di driver all'interno di un'applicazione.
ACM_DRIVERADDF_NAME	Il parametro lParam è un nome di valore del Registro di sistema in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Drivers32. Il valore identifica una DLL che implementa un codec ACM. Le applicazioni possono usare questo flag se vengono create nuove voci del Registro di sistema dopo che l'applicazione ha già iniziato a usare ACM.
ACM_DRIVERADDF_NOTIFYHWND	Il parametro lParam è un handle di una finestra di notifica che riceve messaggi quando vengono apportate modifiche alle priorità e agli stati globali del driver. Il messaggio della finestra da ricevere viene definito dall'applicazione e deve essere passato in dwPriority. I parametri wParam e lParam passati con il messaggio della finestra sono riservati per uso futuro e devono essere ignorati. ACM_DRIVERADDF_GLOBAL non può essere specificato in combinazione con questo flag. Per altre informazioni sulle priorità del driver, vedere la descrizione per la funzione acmDriverPriority .

Valore restituito

Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
MMSYSERR_INVALFLAG	Almeno un flag non è valido.
MMSYSERR_INVALPARAM	Almeno un parametro non è valido.
MMSYSERR_NOMEM	Il sistema non è in grado di allocare risorse.

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

Share via