AcxDeviceAddCircuitDevice, fonction (acxdevice.h)
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
WDFDEVICE représentant le parent auquel le périphérique de circuit sera ajouté.
Device
WDFDEVICE représentant le périphérique de circuit à ajouter à l’appareil parent.
Valeur retournée
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 des 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 ACX minimale : 1.0
Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | acxdevice.h |
| IRQL | PASSIVE_LEVEL |