通过

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

方法集 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 不为零时 *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 header] (index.md)