AcxDeviceRemoveCircuit-Funktion (acxdevice.h)

  • Artikel

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

Syntax

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parameter

Device

Der WDFDEVICE , aus dem die durch den Circuit-Parameter angegebene Audioschaltung entfernt werden soll.

Circuit

Die Audioschaltung, die aus dem durch den Device-Parameter angegebenen WDFDEVICE entfernt werden soll.

Rückgabewert

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

Hinweise

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

Diese Funktion kann nur über die 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

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