función ACX_REQUEST_PARAMETERS_INIT_METHOD (acxrequest.h)

La función ACX_REQUEST_PARAMETERS_INIT_METHOD inicializa una estructura ACX_REQUEST_PARAMETERS con parámetros del 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 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

Identificador de elemento del itemType, por ejemplo, el identificador de patilla 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 Args. Establézcalo 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. Establézcalo en 0 si no se usa Result.

Valor devuelto

Ninguno

Observaciones

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
encabezado de	acxrequest.h

Consulte también

• encabezado acxrequest.h