次の方法で共有


ACX_REQUEST_PARAMETERS_INIT_METHOD関数 (acxrequest.h)

ACX_REQUEST_PARAMETERS_INIT_METHOD 関数は、ACX メソッド パラメーターを使用してACX_REQUEST_PARAMETERS構造体を初期化します。

構文

void ACX_REQUEST_PARAMETERS_INIT_METHOD(
  PACX_REQUEST_PARAMETERS Params,
  const GUID              Set,
  ULONG                   Id,
  ACX_METHOD_VERB         Verb,
  ACX_ITEM_TYPE           ItemType,
  ULONG                   ItemId,
  PVOID                   Args,
  ULONG                   ArgsCb,
  PVOID                   Result,
  ULONG                   ResultCb
);

パラメーター

Params

メソッド パラメーターの格納に使用 ACX_REQUEST_PARAMETERS 構造体へのポインター。

Set

メソッド Set ID (GUID)。

Id

メソッド Set ID 内のメソッド ID (ULONG)。

Verb

ACX_METHOD_VERB 列挙型で定義されているように送信する ACX メソッド動詞。

ItemType

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

ItemId

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

Args

指定したメソッドの追加パラメーターを保持する省略可能な Args バッファー。 存在しない場合は null に設定します。

ArgsCb

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

Result

操作の結果を古いものにするためのオプションの結果バッファー。 存在しない場合、または ResultCb が 0 でないときに *SendMethod で割り当てる必要がある場合は、null に設定します。 呼び出し元は、割り当てられたバッファーを解放する必要があります。

ResultCb

結果バッファーのバイト数 (サイズ)。 Result を使用しない場合は 0 に設定します。

戻り値

何一つ

備考

使用例を次に示します。

            arg     = circuitArg;
            result  = 0;

            //
            // Format and send the request.
            //
            ACX_REQUEST_PARAMETERS_INIT_METHOD(
                &params,
                methodsTests[i].MethodSet,
                methodsTests[i].MethodId,
                AcxMethodVerbSend,
                AcxItemTypeCircuit,
                AcxItemIdNone,
                &arg, sizeof(arg),      // Args & size
                &result, sizeof(result) // Result & size
                );

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、ACX バージョンの概要 参照してください。

必要条件

要件 価値
ヘッダー acxrequest.h

関連項目

  • acxrequest.h ヘッダー する