função ACX_REQUEST_PARAMETERS_INIT_METHOD (acxrequest.h)

Artigo
02/06/2025

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

Uma ID de conjunto de métodos (GUID).

Id

Uma ID de método (ULONG) dentro da ID do conjunto de métodos.

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 pino se o ItemType for um pin.

Args

Um buffer do 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 o Resultado não for usado.

Valor de retorno

Nenhum

Observações

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 versões do ACX, consulte visão geral da versão do ACX.

Requisitos

Requisito	Valor
cabeçalho	acxrequest.h

Consulte também

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

Compartilhar via