Share via

função ACX_REQUEST_PARAMETERS_INIT_METHOD (acxrequest.h)

  • Artigo

A função ACX_REQUEST_PARAMETERS_INIT_METHOD inicializa um struct ACX_REQUEST_PARAMETERS com parâmetros de método ACX.

Sintaxe

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

Um ponteiro para ACX_REQUEST_PARAMETERS estrutura usada para armazenar parâmetros de método.

Set

Um GUID (ID do conjunto de métodos).

Id

Uma ID de método (ULONG) dentro do método Set ID.

Verb

O verbo do método ACX a ser enviado conforme definido pela enumeração ACX_METHOD_VERB .

ItemType

O ACX_ITEM_TYPE tipo de item que está sendo enviado, por exemplo, AcxItemTypeCircuit.

ItemId

A ID do item do ItemType, por exemplo, a ID do pin se o ItemType for um pin.

Args

Um buffer Args opcional que contém parâmetros adicionais para o método especificado. Defina como nulo se não estiver presente.

ArgsCb

A contagem em bytes (tamanho) do buffer do Args. Defina como 0 se o campo Args não for usado.

Result

Um buffer de resultado opcional para antigar o resultado da operação. Defina como nulo se não estiver presente ou se *SendMethod precisar alocá-lo quando ResultCb não for zero. O chamador é responsável por liberar o buffer alocado.

ResultCb

A contagem em bytes (tamanho) do buffer resultado. Defina como 0 se Result não for usado.

Retornar valor

Nenhum

Comentários

Exemplo

O uso de exemplo é mostrado abaixo.

            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 do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre as versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxrequest.h

Confira também

  • [cabeçalho acxrequest.h] (index.md)