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

Статья
02/22/2024

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) в свойстве Set ID.

Verb

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

ItemType

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

ItemId

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

Control

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

ControlCb

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

Value

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

ValueCb

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

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

None

Remarks

Пример

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


    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

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