AcxDeviceRemoveCircuitDevice-Funktion (acxdevice.h)
Die AcxDeviceRemoveCircuitDevice-Funktion entfernt ein ACX-Leitungsgerät aus einem angegebenen übergeordneten Gerät.
Syntax
NTSTATUS AcxDeviceRemoveCircuitDevice(
WDFDEVICE ParentDevice,
WDFDEVICE Device
);
Parameter
ParentDevice
Der übergeordnete WDFDEVICE , von dem das ACX-Leitungsgerät entfernt werden soll.
Device
Der WDFDEVICE , der das Verbindungsgerät darstellt, das aus dem ü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.
Hinweise
Audiotreiber verwenden diese Funktion, um einen vorhandenen Audioendpunkt zu entfernen.
Diese Funktion kann jederzeit während des Lebenszyklus des Fahrers aufgerufen werden. Plug & Play achtet darauf, das Entfernen des Geräts und der zugehörigen Leitungen in Bezug auf andere Plug & Play Aktivitäten auf den übergeordneten und gleichgeordneten Geräten zu serialisieren.
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
ACX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | acxdevice.h |
| IRQL | PASSIVE_LEVEL |