Share via

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE función de devolución de llamada (acxcircuit.h)

  • Artículo

ACX invoca la devolución de llamada EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE cuando el controlador debe eliminar un WDFDEVICE creado previamente asociado a un objeto ACXCIRCUIT.

Sintaxis

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;

NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
  WDFDEVICE Parent,
  ACXFACTORYCIRCUIT Factory,
  WDFDEVICE Device
)
{...}

Parámetros

Parent

Objeto WDFDEVICE (descrito en Resumen de objetos de marco) que es el elemento primario del objeto WDFDEVICE al que se hace referencia en el objeto Device.

Factory

Objeto ACXFACTORYCIRCUIT de fábrica de circuitos existente. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

Device

Objeto WDFDEVICE (descrito en Resumen de objetos de marco) que se debe eliminar.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

AcxFactoryCircuit representa un objeto de fábrica capaz de crear un ACXCIRCUIT a petición.

Un controlador puede registrar uno o varios ACXFACTORYCIRCUIT con ACX, esta acción permitirá a ACX saber que el controlador es capaz de crear ACXCIRCUIT de un tipo bien definido.

ACX invoca las devoluciones de llamada de ACXFACTORYCIRCUIT cuando detecta que una ruta de acceso de audio requiere uno de los ACXCIRCUITs proporcionados por el generador.

Esta es una devolución de llamada opcional, si no se define la devolución de llamada EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE, ACX realiza la acción predeterminada de quitar el WDFDEVICE especificado de la lista de dispositivos enumerados. Esta acción desencadena una notificación PnP eliminada sorpresa al WDFDEVICE secundario.

El objeto ACXFACTORYCIRCUIT admite ACXCIRCUITs dinámicos, lo que significa que cada ACXCIRCUIT creado por la fábrica está asociado a un WDFDEVICE y estos dos objetos tienen la misma duración.

AcxFactoryCircuit tiene una cola WDF dedicada. Para obtener más información sobre las colas de WDF, vea Objetos de cola de marco.

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
Header acxcircuit.h
IRQL PASSIVE_LEVEL

Consulte también