Partager via

AcxCircuitInitAssignProperties, fonction (acxcircuit.h)

  • Article

La fonction AcxCircuitInitAssignProperties attribue une ou plusieurs propriétés ACX pour ACXCIRCUIT.

Syntaxe

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

Paramètres

CircuitInit

Structure ACXCIRCUIT_INIT qui définit l’initialisation du circuit. ACXCIRCUIT_INIT est un objet opaque utilisé pour l’initialisation de circuit. Utilisez AcxCircuitInitAllocate pour initialiser la structure ACXCIRCUIT_INIT.

Properties

Structure ACX_PROPERTY_ITEM qui définit un ensemble de propriétés qui seront utilisées pour l’initialisation de circuit par la fabrique de circuits.

PropertiesCount

Nombre de propriétés qui seront ajoutées au circuit. Il s’agit d’un nombre basé sur un.

Valeur de retour

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.

Remarques

Les pilotes doivent uniquement ajouter des propriétés détenues par le pilote.

Exemple

L’exemple d’utilisation est illustré ci-dessous.


    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));

Configuration requise pour ACX

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence Valeur
d’en-tête acxcircuit.h
IRQL PASSIVE_LEVEL

Voir aussi