função ACX_REQUEST_PARAMETERS_INIT_PROPERTY (acxrequest.h)

Artigo
02/06/2025

O ACX_REQUEST_PARAMETERS_INIT_PROPERTY inicializa um struct ACX_REQUEST_PARAMETERS com parâmetros de propriedade ACX.

Sintaxe

void ACX_REQUEST_PARAMETERS_INIT_PROPERTY(
  PACX_REQUEST_PARAMETERS Params,
  const GUID              Set,
  ULONG                   Id,
  ACX_PROPERTY_VERB       Verb,
  ACX_ITEM_TYPE           ItemType,
  ULONG                   ItemId,
  PVOID                   Control,
  ULONG                   ControlCb,
  PVOID                   Value,
  ULONG                   ValueCb
);

Parâmetros

Params

Um ponteiro para ACX_REQUEST_PARAMETERS estrutura usada para armazenar parâmetros de propriedade.

Set

Uma ID de conjunto de propriedades (GUID).

Id

Uma ID de propriedade (ULONG) dentro da ID do conjunto de propriedades.

Verb

O verbo da propriedade ACX a ser enviado conforme definido pela enumeração ACX_PROPERTY_VERB.

ItemType

O ACX_ITEM_TYPE tipo de item que está sendo enviado, por exemplo, AcxItemTypeCircuit.

ItemId

A ID do item do ItemType, por exemplo, a ID do pino se o ItemType for um pin.

Control

Um buffer de controle opcional que contém parâmetros adicionais para a propriedade especificada. Defina como nulo se não estiver presente.

ControlCb

A contagem em bytes (tamanho) do buffer de controle. Defina como 0 se o campo Controle não for usado.

Value

Um buffer de valor opcional para especificar ou receber o valor da propriedade. Defina como nulo se não estiver presente ou se *SendProperty precisar alocá-lo quando ValueCb não for zero. O chamador é responsável por liberar o buffer alocado.

ValueCb

A contagem em bytes (tamanho) do buffer valor. Defina como 0 se Valor não for usado.

Valor de retorno

Nenhum

Observações

Exemplo

O uso de exemplo é mostrado abaixo.


    NTSTATUS                    status = STATUS_SUCCESS;
    PKSPIN_PHYSICALCONNECTION   physicalConnection = nullptr;
    PAUDIO_PATH_DESCRIPTOR      descriptor = nullptr;

    // For the Audio Circuit, send a request to each Target Pin asking KSPROPERTY_PIN_PHYSICALCONNECTION
    // This will give us symbolic link of the next circuit in the Audio Path (if there is any)

    for (ULONG i = 0; i < ARRAYSIZE(AudioCircuit->Pins) && AudioCircuit->Pins[i].TargetPin; ++i)
    {
        ACX_REQUEST_PARAMETERS requestParams{ 0 };

        ACX_REQUEST_PARAMETERS_INIT_PROPERTY(
            &requestParams,
            KSPROPSETID_Pin,
            KSPROPERTY_PIN_PHYSICALCONNECTION,
            AcxPropertyVerbGet,
            AcxItemTypePin,
            i,
            nullptr,
            0,
            // null Value so SendProperty will allocate it for us. We'll need to free it.
            nullptr,
            0);
...

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	acxrequest.h

Consulte também

de cabeçalho acxrequest.h

Partilhar via