функция ACX_REQUEST_PARAMETERS_INIT_PROPERTY (acxrequest.h)

Статья
02/06/2025

ACX_REQUEST_PARAMETERS_INIT_PROPERTY инициализирует структуру ACX_REQUEST_PARAMETERS с параметрами свойства ACX.

Синтаксис

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
);

Параметры

Params

Указатель на ACX_REQUEST_PARAMETERS структуру, которая используется для хранения параметров свойства.

Set

Идентификатор набора свойств (GUID).

Id

Идентификатор свойства (ULONG) в идентификаторе набора свойств.

Verb

Команда свойства ACX для отправки в соответствии с перечислением ACX_PROPERTY_VERB.

ItemType

Тип отправленного элемента ACX_ITEM_TYPE, например AcxItemTypeCircuit.

ItemId

Идентификатор элемента объекта ItemType, например идентификатор пин-кода, если элемент ItemType является закреплением.

Control

Необязательный буфер управления, содержащий дополнительные параметры для указанного свойства. Установите значение NULL, если нет.

ControlCb

Количество в байтах (размер) буфера элемента управления. Установите значение 0, если поле control не используется.

Value

Необязательный буфер значений для указания или получения значения свойства. Установите значение NULL, если нет или если *SendProperty необходимо выделить его, если ЗначениеCb не равно нулю. Вызывающий объект отвечает за освобождение выделенного буфера.

ValueCb

Количество в байтах (размер) буфера значений. Установите значение 0, если значение не используется.

Возвращаемое значение

Никакой

Замечания

Пример

Ниже показан пример использования.


    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);
...

Требования к ACX

минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в обзоре версий ACX.

Требования

Требование	Ценность
заголовка	acxrequest.h

См. также

заголовка acxrequest.h

Поделиться через