AcxDeviceRemoveCircuitDevice, fonction (acxdevice.h)
La fonction AcxDeviceRemoveCircuitDevice supprime un périphérique de circuit ACX d’un appareil parent spécifié.
Syntaxe
NTSTATUS AcxDeviceRemoveCircuitDevice(
WDFDEVICE ParentDevice,
WDFDEVICE Device
);
Paramètres
ParentDevice
WDFDEVICE parent à partir duquel supprimer le périphérique de circuit ACX.
Device
WDFDEVICE représentant le périphérique de circuit à supprimer de l’appareil parent.
Valeur retournée
AcxDeviceRemoveCircuitDevice 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 supprimer un point de terminaison audio existant.
Cette fonction peut être appelée à tout moment pendant le cycle de vie du pilote. Plug-and-Play veille à sérialiser la suppression 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
NTSTATUS status;
WDFDEVICE Device;
WDFDEVICE child;
// Code to initialize WDFDEVICE objects...
// Remove the child device.
status = AcxDeviceRemoveCircuitDevice(Device, child);
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 |