Función AcxDeviceAddFactoryCircuit (acxdevice.h)
La función AcxDeviceAddFactoryCirc uit 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 de ACX.
Factory
Circuito de fábrica de ACX que se va a agregar al WDFDEVICE de 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.
Observaciones
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 generador de circuitos. El marco ACX usa la fábrica registrada para pedir al controlador que cree un 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 |
|---|---|
| encabezado de | acxdevice.h |
| irQL | PASSIVE_LEVEL |