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 がピンの場合は pin 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 バージョンの概要」を参照してください。

要件

要件	値
Header	acxrequest.h

こちらもご覧ください

• [acxrequest.h ヘッダー](index.md)