Funzione acmDriverAddW (msacm.h)

Articolo
11/20/2024

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 acmDriverAddW(
  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 di Gestione configurazione di Azure.

hinstModule

Handle per l'istanza del modulo il cui file eseguibile o dll 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 di 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. Questo vale se viene specificato o meno ACM_DRIVERADDF_GLOBAL. Per altre informazioni, vedere Aggiunta di driver all'interno di un'applicazione.
ACM_DRIVERADDF_LOCAL	Gestione configurazione di Azure assegna automaticamente a un driver locale una 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 è 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à dei 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 possibili valori di errore 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.

Osservazioni

Nota

L'intestazione msacm.h definisce acmDriverAdd come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	msacm.h
libreria	Msacm32.lib
dll	Msacm32.dll

Vedere anche

funzioni di compressione audio

gestione compressione audio

Condividi tramite