función ACX_REQUEST_PARAMETERS_INIT_METHOD (acxrequest.h)

Artículo
02/27/2024

La función ACX_REQUEST_PARAMETERS_INIT_METHOD inicializa una estructura de ACX_REQUEST_PARAMETERS con parámetros de método ACX.

Sintaxis

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
);

Parámetros

Params

Puntero a ACX_REQUEST_PARAMETERS estructura que se usa para almacenar parámetros de método.

Set

Un método Set ID (GUID).

Id

Identificador de método (ULONG) dentro del método Set ID.

Verb

Verbo del método ACX que se va a enviar tal y como se define en la enumeración ACX_METHOD_VERB .

ItemType

El ACX_ITEM_TYPE tipo de elemento que se envía, por ejemplo AcxItemTypeCircuit.

ItemId

El identificador de elemento del ItemType, por ejemplo, el identificador de anclaje si ItemType es un pin.

Args

Un búfer Args opcional que contiene parámetros adicionales para el método especificado. Se establece en NULL si no está presente.

ArgsCb

Recuento en bytes (tamaño) del búfer de argumentos. Se establece en 0 si no se usa el campo Args.

Result

Un búfer de resultados opcional a la antigüedad del resultado de la operación. Se establece en null si no está presente o si *SendMethod debe asignarlo cuando ResultCb no es cero. El autor de la llamada es responsable de liberar el búfer asignado.

ResultCb

Recuento en bytes (tamaño) del búfer de resultados. Establezca en 0 si no se usa Result.

Valor devuelto

None

Notas

Ejemplo

A continuación se muestra el uso de ejemplo.

            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
                );

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito	Valor
Header	acxrequest.h

Consulte también

[encabezado acxrequest.h] (index.md)

Share via