Compartir a través de


Función AcxDeviceRemoveFactoryCircuit (acxdevice.h)

La función acxDeviceRemoveFactoryCircuit quita un circuito de fábrica para crear circuitos de audio de un WDFDEVICE.

Sintaxis

NTSTATUS AcxDeviceRemoveFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

Parámetros

Device

El WDFDEVICE del que se quitará el circuito de fábrica de ACX.

Factory

Circuito de fábrica de ACX que se va a quitar del WDFDEVICE especificado por el parámetro device .

Valor devuelto

acxDeviceRemoveFactoryCircuit devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error NTSTATUS.

Observaciones

Un controlador típico no necesitará llamar a AcxDeviceRemoveFactoryCircuit. No se debe llamar a esta función si el circuito de fábrica ha creado dispositivos de circuito que todavía están activos.

Si un controlador decide llamar a esta función para un circuito de fábrica, el controlador se hace responsable de quitar primero los dispositivos de circuito creados a través del circuito de fábrica asociado, antes dese llama a AcxDeviceRemoveFactoryCircuit.

Para obtener más información sobre cómo trabajar con circuitos, consulte de eliminación dinámica del circuito ACX y enumeración de dispositivos ACX.

Solo se puede llamar a esta función desde la función de devolución de llamada EVT_WDF_DEVICE_RELEASE_HARDWARE para este dispositivo.

Use AcxDeviceAddFactoryCircuit para agregar un circuito de fábrica a unWDFDEVICE .

Requisitos de ACX

versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte introducción a la versión de ACX.

Requisitos

Requisito Valor
encabezado de acxdevice.h
irQL PASSIVE_LEVEL

Consulte también