Función AcxDeviceAddFactoryCircuit (acxdevice.h)

  • Artículo

La función AcxDeviceAddFactoryCircuit agrega un circuito de fábrica a un WDFDEVICE para crear circuitos de audio.

Sintaxis

NTSTATUS AcxDeviceAddFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

Parámetros

Device

WDFDEVICE al que se agregará el circuito de fábrica ACX.

Factory

Circuito de fábrica ACX que se va a agregar al WDFDEVICE especificado por el parámetro Device .

Valor devuelto

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

Comentarios

Un controlador ACX puede crear uno o varios circuitos en los escenarios siguientes:

  • En el momento de la inicialización
  • En tiempo de ejecución, como efecto secundario de un evento externo, como detectar un nuevo componente de audio
  • Porque se registró con ACX como factoría de circuitos. El marco ACX usa la fábrica registrada para pedir al controlador que cree un nuevo circuito.

Use AcxDeviceRemoveFactoryCircuit para quitar un circuito de fábrica de un WDFDEVICE.

Esta función solo se puede llamar desde la función de devolución de llamada EVT_WDF_DEVICE_PREPARE_HARDWARE para este dispositivo.

Ejemplo

WDFDEVICE                Device;
NTSTATUS                 status;
PCAPTURE_DEVICE_CONTEXT  devCtx;

// Code to initialize WDFDEVICE...

//
// Add control circuit to child's list.
//
status = AcxDeviceAddFactoryCircuit(Device, devCtx->CtrlCircuit);

if (!NT_SUCCESS(status))
{
    ASSERT(FALSE);
    goto exit;
}

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

Consulte también