AcxCircuitInitAssignProperties-Funktion (acxcircuit.h)

  • Artikel

Die AcxCircuitInitAssignProperties-Funktion weist eine oder mehrere ACX-Eigenschaften für den ACXCIRCUIT zu.

Syntax

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

Parameter

CircuitInit

Die ACXCIRCUIT_INIT-Struktur, die die Leitungsinitialisierung definiert. ACXCIRCUIT_INIT ist ein undurchsichtiges Objekt, das für die Leitungsinitialisierung 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 Leitungsinitialisierung von der Leitungsfabrik verwendet werden.

PropertiesCount

Die Anzahl der Eigenschaften, die der Verbindung hinzugefügt werden. Dies ist eine einsbasierte Anzahl.

Rückgabewert

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

Hinweise

Treiber sollten nur treibereigene Eigenschaften hinzufügen.

Beispiel

Die Verwendungsbeispiele finden Sie unten.


    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

AcX-Mindestversion: 1.0

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

Anforderungen

Anforderung Wert
Header acxcircuit.h
IRQL PASSIVE_LEVEL

Weitere Informationen