Compartilhar via

Função AcxCircuitInitAssignProperties (acxcircuit.h)

  • Artigo

A função AcxCircuitInitAssignProperties atribui uma ou mais propriedades ACX para o ACXCIRCUIT.

Sintaxe

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

Parâmetros

CircuitInit

A estrutura ACXCIRCUIT_INIT que define a inicialização do circuito. ACXCIRCUIT_INIT é um objeto opaco usado para inicialização de circuito. Use AcxCircuitInitAllocate para inicializar a estrutura ACXCIRCUIT_INIT.

Properties

Uma estrutura ACX_PROPERTY_ITEM que define um conjunto de propriedades que serão usadas para inicialização de circuito pela fábrica de circuitos.

PropertiesCount

O número de propriedades que serão adicionadas ao circuito. Esta é uma contagem baseada em um.

Retornar valor

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Os drivers só devem adicionar propriedades de propriedade do driver.

Exemplo

O uso de exemplo é mostrado abaixo.


    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 do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxcircuit.h
IRQL PASSIVE_LEVEL

Confira também