AcxDeviceRemoveCircuitDevice-Funktion (acxdevice.h)

  • Artikel

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

Weitere Informationen