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 内のプロパティ ID (ULONG)。

Verb

ACX_PROPERTY_VERB列挙で定義されているように送信する ACX プロパティ動詞。

ItemType

送信されるアイテムの ACX_ITEM_TYPE の種類 (例: AcxItemTypeCircuit)。

ItemId

ItemType のアイテム ID (ItemType がピンの場合は pin ID など)。

Control

指定したプロパティの追加パラメーターを保持するコントロール バッファー (省略可能)。 存在しない場合は null に設定します。

ControlCb

コントロール バッファーのバイト数 (サイズ)。 Control フィールドが使用されていない場合は、0 に設定します。

Value

プロパティの値を指定または受け取る省略可能な Value バッファー。 存在しない場合、または ValueCb が 0 でないときに *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

こちらもご覧ください

• acxrequest.h ヘッダー