Freigeben über


AcxDeviceRemoveCircuit-Funktion (acxdevice.h)

Die AcxDeviceRemoveCircuit-funktion entfernt die angegebene Audioschaltung von einem ACX-Gerät.

Syntax

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parameter

Device

Die WDFDEVICE-, aus der die durch den parameter Circuit angegebene Audioschaltung entfernt werden soll.

Circuit

Die Audioschaltung, die aus dem WDFDEVICE entfernt werden soll, der durch den Parameter Device angegeben wird.

Rückgabewert

AcxDeviceRemoveCircuit gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein NTSTATUS Fehlercode zurückgegeben.

Bemerkungen

Verwenden Sie AcxDeviceAddCircuit-, um einer WDFDEVICE-eine Audioschaltung hinzuzufügen.

Diese Funktion kann nur von der EVT_WDF_DEVICE_RELEASE_HARDWARE Rückruffunktion für dieses Gerät aufgerufen werden.

Beispiel

NTSTATUS              status;
WDFDEVICE             Device = NULL;
PUSBA2_DEVICE_CONTEXT devCtx;

// Code to initialize WDFDEVICE...

devCtx = GetDeviceContext(Device);

//
// Unregister filter and delete this audio filter.
//
if (devCtx->RenderCircuitAdded) {
    ASSERT(devCtx->RenderCircuit);
    status = AcxDeviceRemoveCircuit(Device, devCtx->RenderCircuit);

    devCtx->RenderCircuit = NULL;
    devCtx->RenderCircuitAdded = FALSE;
}

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

Siehe auch