AcxDeviceAddCircuitDevice, fonction (acxdevice.h)

Article
02/06/2025

La fonction AcxDeviceAddCircuitDevice ajoute un périphérique de circuit ACX à un appareil parent spécifié représentant un chemin audio.

Syntaxe

NTSTATUS AcxDeviceAddCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

Paramètres

ParentDevice

Une WDFDEVICE représentant le parent auquel l’appareil de circuit sera ajouté.

Device

Une WDFDEVICE représentant l’appareil de circuit à ajouter à l’appareil parent.

Valeur de retour

AcxDeviceAddCircuitDevice retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur NTSTATUS.

Remarques

Les pilotes audio utilisent cette fonction pour énumérer un nouveau point de terminaison audio.

Cette fonction peut être appelée à tout moment pendant le cycle de vie du pilote. Plug-and-Play sérialise l’énumération de l’appareil et les circuits associés, par rapport à d’autres activités Plug-and-Play sur les appareils parents et frères.

Exemple

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;
}

Configuration requise pour ACX

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence	Valeur
d’en-tête	acxdevice.h
IRQL	PASSIVE_LEVEL

Partager via