共用方式為

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

方法集合標識碼內的方法識別碼 （ULONG）。

Verb

要傳送的 ACX 方法動詞命令，如 ACX_METHOD_VERB 列舉所定義。

ItemType

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

ItemId

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

Args

選擇性的 Args 緩衝區，包含指定方法的其他參數。 如果不存在，則設定為 null。

ArgsCb

Args 緩衝區的位元組 （size） 計數。 如果未使用 Args 字段，則設定為 0。

Result

選擇性的 Result 緩衝區，以舊有作業的結果。 如果不存在，則設定為 null，如果 *SendMethod 在 ResultCb 不是零時需要配置它。 呼叫端負責釋放配置的緩衝區。

ResultCb

Result 緩衝區的位元組 （size） 計數。 如果未使用 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 標頭]（index.md）