función ACX_REQUEST_PARAMETERS_INIT_PROPERTY (acxrequest.h)

Artículo
02/22/2024

El ACX_REQUEST_PARAMETERS_INIT_PROPERTY inicializa una estructura de ACX_REQUEST_PARAMETERS con parámetros de propiedad ACX.

Sintaxis

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

Puntero a ACX_REQUEST_PARAMETERS estructura que se usa para almacenar parámetros de propiedad.

Set

Un identificador de conjunto de propiedades (GUID).

Id

Identificador de propiedad (ULONG) dentro de la propiedad Set ID.

Verb

Verbo de propiedad ACX que se va a enviar tal y como se define en la enumeración ACX_PROPERTY_VERB .

ItemType

El ACX_ITEM_TYPE tipo de elemento que se envía, por ejemplo AcxItemTypeCircuit.

ItemId

Identificador de elemento del itemType, por ejemplo, el identificador de anclaje si ItemType es un pin.

Control

Un búfer de control opcional que contiene parámetros adicionales para la propiedad especificada. Se establece en NULL si no está presente.

ControlCb

Recuento en bytes (tamaño) del búfer de control. Se establece en 0 si no se usa el campo Control.

Value

Un búfer de valor opcional para especificar o recibir el valor de la propiedad. Se establece en NULL si no está presente o si *SendProperty debe asignarlo cuando ValueCb no es cero. El autor de la llamada es responsable de liberar el búfer asignado.

ValueCb

Recuento en bytes (tamaño) del búfer valor. Establezca en 0 si no se usa Value.

Valor devuelto

None

Notas

Ejemplo

A continuación se muestra un ejemplo de uso.


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

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito	Valor
Header	acxrequest.h

Consulte también

Encabezado acxrequest.h

Share via