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

屬性標識碼 (設定標識碼內的ULONG) 。

Verb

要依 ACX_PROPERTY_VERB 列舉所定義傳送的 ACX 屬性動詞。

ItemType

要傳送之專案的 ACX_ITEM_TYPE 類型，例如 AcxItemTypeCircuit。

ItemId

ItemType 的項目標識符，例如，如果 ItemType 是釘選，則為釘選標識符。

Control

選擇性的 Control 緩衝區，保存指定屬性的其他參數。 如果不存在，請將 設定為 null。

ControlCb

控制緩衝區 (大小) 的位元組計數。 如果未使用 [控件] 字段，請將 設定為 0。

Value

選擇性的 Value 緩衝區，可指定或接收屬性值。 如果不存在，或 *SendProperty 需要在 ValueCb 不是零時配置它，則設定為 null。 呼叫端負責釋放配置的緩衝區。

ValueCb

value 緩衝區的大小) 位元組 (計數。 如果未使用 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 標頭