Share via


Función AcxCircuitInitAssignProperties (acxcircuit.h)

La función AcxCircuitInitAssignProperties asigna una o varias propiedades ACX para ACXCIRCUIT.

Sintaxis

NTSTATUS AcxCircuitInitAssignProperties(
  PACXCIRCUIT_INIT   CircuitInit,
  PACX_PROPERTY_ITEM Properties,
  ULONG              PropertiesCount
);

Parámetros

CircuitInit

Estructura ACXCIRCUIT_INIT que define la inicialización del circuito. ACXCIRCUIT_INIT es un objeto opaco que se usa para la inicialización del circuito. Use AcxCircuitInitAllocate para inicializar la estructura ACXCIRCUIT_INIT.

Properties

Estructura ACX_PROPERTY_ITEM que define un conjunto de propiedades que el generador de circuitos usará para la inicialización del circuito.

PropertiesCount

Número de propiedades que se agregarán al circuito. Se trata de un recuento basado.

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

Los controladores solo deben agregar propiedades propiedad del controlador.

Ejemplo

A continuación se muestra un ejemplo de uso.


    PACXCIRCUIT_INIT circuitInit = NULL;
    circuitInit = AcxCircuitInitAllocate(Device);

    ACX_PROPERTY_ITEM CircuitProperties[] =
    {
        {
            &KSPROPSETID_AudioPosture,
            KSPROPERTY_AUDIOPOSTURE_ORIENTATION,
            KSPROPERTY_TYPE_SET,
            EvtCircuitPropertyHandler,
            nullptr,                            //Reserved
            0,                                  //ControlCb
            sizeof(AUDIOPOSTURE_ORIENTATION),   //ValueCb
        },
    };


    status = AcxCircuitInitAssignProperties(circuitInit,
        CircuitProperties,
        SIZEOF_ARRAY(CircuitProperties));

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