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
Le parent WDFDEVICE duquel supprimer l’appareil de circuit ACX.
Device
Le WDFDEVICE représentant l’appareil de circuit à supprimer de l’appareil parent.
Valeur de retour
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 s’occupe de sérialiser la suppression 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
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 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 |
Voir aussi
- AcxDeviceRemoveCircuit
- d’en-tête acxdevice.h