Condividi tramite

Funzione AcxDeviceAddCircuitDevice (acxdevice.h)

  • Articolo

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 dispositivo WDF che rappresenta l'elemento padre a cui verrà aggiunto il dispositivo del circuito.

Device

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 codice di errore NTSTATUS .

Commenti

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à di 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 di ACX

Versione minima di ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.

Requisiti

Requisito Valore
Intestazione acxdevice.h
IRQL PASSIVE_LEVEL

Vedi anche