EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT función de devolución de llamada (acxcircuit.h)
ACX invoca la EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT devolución de llamada cuando el controlador debe crear un objeto ACXCIRCUIT con la configuración especificada.
Sintaxis
EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT EvtAcxFactoryCircuitCreateCircuit;
NTSTATUS EvtAcxFactoryCircuitCreateCircuit(
WDFDEVICE Parent,
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory,
PACX_FACTORY_CIRCUIT_ADD_CIRCUIT Config,
PACXCIRCUIT_INIT CircuitInit
)
{...}
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.
Device
Objeto WDFDEVICE (descrito en Resumen de objetos de marco) creado en la devolución de llamada de EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUITDEVICE. Este dispositivo se asociará con el nuevo ACXCIRCUIT.
Factory
Objeto ACXFACTORYCIRCUIT de fábrica de circuitos existente. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.
Config
Estructura ACX_FACTORY_CIRCUIT_ADD_CIRCUIT que define la configuración del nuevo ACXCIRCUIT.
CircuitInit
ACXCIRCUIT_INIT es un objeto opaco que se usa para la inicialización del circuito. Use acxCircuitInitAllocate para inicializar la estructura de ACXCIRCUIT_INIT.
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 Using NTSTATUS Values.
Observaciones
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 informará a ACX de 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.
AcxFactoryCircuit tiene una cola WDF dedicada. Para obtener más información sobre las colas de WDF, vea Framework Queue Objects.
Ejemplo
A continuación se muestra el uso de ejemplo.
EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT Dsp_EvtAcxFactoryCircuitCreateCircuit;
NTSTATUS
Dsp_EvtAcxFactoryCircuitCreateCircuit(
_In_ WDFDEVICE Parent,
_In_ WDFDEVICE Device,
_In_ ACXFACTORYCIRCUIT Factory,
_In_ PACX_FACTORY_CIRCUIT_ADD_CIRCUIT CircuitConfig,
_In_ PACXCIRCUIT_INIT CircuitInit
)
{
ACXOBJECTBAG circuitProperties;
PAGED_CODE();
NTSTATUS status = STATUS_SUCCESS;
// Create object bag from the CompositeProperties
ACX_OBJECTBAG_CONFIG propConfig;
ACX_OBJECTBAG_CONFIG_INIT(&propConfig);
propConfig.Handle = CircuitConfig->CircuitProperties;
propConfig.Flags |= AcxObjectBagConfigOpenWithHandle;
WDF_OBJECT_ATTRIBUTES attributes;
WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
RETURN_NTSTATUS_IF_FAILED(AcxObjectBagOpen(&attributes, &propConfig, &circuitProperties));
auto cleanupPropConfig = scope_exit([=]() {
WdfObjectDelete(circuitProperties);
}
);
// Retrieve the intended Circuit ID from the object bag
GUID circuitId;
RETURN_NTSTATUS_IF_FAILED(Dsp_DetermineCircuitGuidFromVendorProperties(circuitProperties, &circuitId));
AcxCircuitInitSetComponentId(CircuitInit, &circuitId);
// Call the appropriate CreateCircuitDevice based on the Circuit ID
if (IsEqualGUID(circuitId, DSP_CIRCUIT_MICROPHONE_GUID) || IsEqualGUID(circuitId, DSP_CIRCUIT_UNIVERSALJACK_CAPTURE_GUID))
{
return DspC_EvtAcxFactoryCircuitCreateCircuit(Parent, Device, Factory, CircuitConfig, CircuitInit);
}
else if (IsEqualGUID(circuitId, DSP_CIRCUIT_SPEAKER_GUID) || IsEqualGUID(circuitId, DSP_CIRCUIT_UNIVERSALJACK_RENDER_GUID))
{
return DspR_EvtAcxFactoryCircuitCreateCircuit(Parent, Device, Factory, CircuitConfig, CircuitInit);
}
status = STATUS_NOT_SUPPORTED;
return status;
}
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 | acxcircuit.h |
| irQL | PASSIVE_LEVEL |