AcxDeviceRemoveCircuitDevice-Funktion (acxdevice.h)
Die AcxDeviceRemoveCircuitDevice Funktion entfernt ein ACX-Schaltkreisgerät von einem angegebenen übergeordneten Gerät.
Syntax
NTSTATUS AcxDeviceRemoveCircuitDevice(
WDFDEVICE ParentDevice,
WDFDEVICE Device
);
Parameter
ParentDevice
Das übergeordnete WDFDEVICE-, aus dem das ACX-Schaltkreisgerät entfernt werden soll.
Device
Die WDFDEVICE-, die das Schaltkreisgerät darstellt, das vom übergeordneten Gerät entfernt werden soll.
Rückgabewert
AcxDeviceRemoveCircuitDevice gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein NTSTATUS Fehlercode zurückgegeben.
Bemerkungen
Audiotreiber verwenden diese Funktion, um einen vorhandenen Audioendpunkt zu entfernen.
Diese Funktion kann während des Lebenszyklus des Fahrers jederzeit aufgerufen werden. Plug and Play sorgt dafür, dass das Gerät entfernt und die zugehörigen Schaltkreise im Verhältnis zu anderen Plug- und Play-Aktivitäten auf den übergeordneten und gleichgeordneten Geräten serialisiert werden.
Beispiel
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;
}
ACX-Anforderungen
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxdevice.h |
| IRQL- | PASSIVE_LEVEL |