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

プロパティ セット ID (GUID)。

Id

プロパティセット ID 内のプロパティ ID (ULONG)。

Verb

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

ItemType

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

ItemId

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

Control

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

ControlCb

コントロール バッファーのバイト数 (サイズ)。 コントロール フィールドが使用されていない場合は 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 バージョンの概要 参照してください。

必要条件

要件	価値
ヘッダー	acxrequest.h

関連項目

• acxrequest.h ヘッダー を する