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
屬性集識別碼 （GUID）。
Id
屬性集標識碼內的屬性標識碼 （ULONG）。
Verb
要傳送的 ACX 屬性動詞命令，如 ACX_PROPERTY_VERB 列舉所定義。
ItemType
要傳送的專案 ACX_ITEM_TYPE 類型，例如 AcxItemTypeCircuit。
ItemId
ItemType 的項目標識符，例如，如果 ItemType 是針腳，則為釘選標識符。
Control
選擇性的 Control 緩衝區，包含指定屬性的其他參數。 如果不存在，則設定為 null。
ControlCb
Control 緩衝區的位元組 （size） 計數。 如果未使用 [控件] 字段，則設定為 0。
Value
要指定或接收屬性值的選擇性 Value 緩衝區。 如果不存在，則設定為 null，如果 *SendProperty 在 ValueCb 不是零時需要配置它。 呼叫端負責釋放配置的緩衝區。
ValueCb
Value 緩衝區的位元組 （size） 計數。 如果未使用 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 版本概觀。
要求
| 要求 | 價值 |
|---|---|
| 標頭 | acxrequest.h |