Funzione AcxDeviceAddCircuitDevice (acxdevice.h)
La funzione AcxDeviceAddCircuitDevice aggiunge un dispositivo circuito ACX a un dispositivo padre specificato che rappresenta un percorso audio.
Sintassi
NTSTATUS AcxDeviceAddCircuitDevice(
WDFDEVICE ParentDevice,
WDFDEVICE Device
);
Parametri
ParentDevice
Un WDFDEVICE che rappresenta l'elemento padre a cui verrà aggiunto il dispositivo del circuito.
Device
Un WDFDEVICE che rappresenta il dispositivo del circuito da aggiungere al dispositivo padre.
Valore restituito
AcxDeviceAddCircuitDevice restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un NTSTATUS codice di errore.
Osservazioni
I driver audio usano questa funzione per enumerare un nuovo endpoint audio.
Questa funzione può essere chiamata in qualsiasi momento durante il ciclo di vita del driver. Plug and Play serializza l'enumerazione del dispositivo e i circuiti associati, in relazione ad altre attività Plug and Play nei dispositivi padre e di pari livello.
Esempio
WDFDEVICE Device;
WDFDEVICE renderDevice = NULL;
NTSTATUS status;
// Code to initialize the WDFDEVICE...
// Code to create the WDFDEVICE renderDevice...
//
// Add circuit to device's dynamic circuit device list.
//
status = AcxDeviceAddCircuitDevice(Device, renderDevice);
if (!NT_SUCCESS(status))
{
ASSERT(FALSE);
goto exit;
}
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxdevice.h |
| IRQL | PASSIVE_LEVEL |