ACX_REQUEST_PARAMETERS_INIT_PROPERTY 函数 (acxrequest.h)
ACX_REQUEST_PARAMETERS_INIT_PROPERTY使用 ACX 属性参数初始化ACX_REQUEST_PARAMETERS结构。
语法
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
属性 Set ID (GUID) 。
Id
属性集 ID (ULONG) 的属性 ID。
Verb
要发送的 ACX 属性谓词，由 ACX_PROPERTY_VERB 枚举定义。
ItemType
要发送的项 ACX_ITEM_TYPE 类型，例如 AcxItemTypeCircuit。
ItemId
ItemType 的项 ID，例如，如果 ItemType 是图钉，则为图钉 ID。
Control
一个可选的控制缓冲区，用于存放指定属性的其他参数。 如果不存在，则设置为 null。
ControlCb
控制缓冲区的大小) (计数（以字节为单位）。 如果未使用 Control 字段，则设置为 0。
Value
用于指定或接收属性值的可选值缓冲区。 如果不存在，或者当 ValueCb 不为零时 *SendProperty 需要分配它，则设置为 null。 调用方负责释放分配的缓冲区。
ValueCb
以字节为单位的计数 (值缓冲区的大小) 。 如果未使用 Value，则设置为 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 版本概述。
要求
| 要求 | 值 |
|---|---|
| Header | acxrequest.h |