acxCircuitInitAssignProperties 函式 (acxcircuit.h)

AcxCircuitInitAssignProperties 函式會為 ACXCIRCUIT 指派一或多個 ACX 屬性。

語法

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

參數

CircuitInit

定義線路初始化的ACXCIRCUIT_INIT結構。 ACXCIRCUIT_INIT是用於線路初始化的不透明物件。 使用 AcxCircuitInitAllocate 初始化ACXCIRCUIT_INIT結構。

Properties

ACX_PROPERTY_ITEM結構，定義一組屬性，用於線路處理站的線路初始化。

PropertiesCount

將新增至線路的屬性數目。 這是一個以計數為基礎的計數。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

驅動程式應該只新增驅動程式擁有的屬性。

範例

範例使用方式如下所示。

    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 需求

最小 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

另請參閱

• acxcircuit.h 標頭