Freigeben über


AcxCircuitInitAssignProperties-Funktion (acxcircuit.h)

Die AcxCircuitInitAssignProperties Funktion weist mindestens eine ACX-Eigenschaft für die ACXCIRCUIT zu.

Syntax

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

Parameter

CircuitInit

Die ACXCIRCUIT_INIT Struktur, die die Schaltkreisinitialisierung definiert. ACXCIRCUIT_INIT ist ein undurchsichtiges Objekt, das für die Schaltkreisinitialisierung verwendet wird. Verwenden Sie AcxCircuitInitAllocate, um die ACXCIRCUIT_INIT Struktur zu initialisieren.

Properties

Eine ACX_PROPERTY_ITEM Struktur, die einen Satz von Eigenschaften definiert, die für die Schaltkreisinitialisierung durch die Schaltkreisfabrik verwendet werden.

PropertiesCount

Die Anzahl der Eigenschaften, die dem Schaltkreis hinzugefügt werden. Dies ist eine 1 basierende Anzahl.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

Treiber sollten nur Eigenschaften im Besitz von Treibern hinzufügen.

Beispiel

Die Beispielverwendung wird unten gezeigt.


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

ACX-Anforderungen

Mindestens ACX-Version: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header- acxcircuit.h
IRQL- PASSIVE_LEVEL

Siehe auch