funzione ACX_REQUEST_PARAMETERS_INIT_METHOD (acxrequest.h)

Articolo
02/26/2024

La funzione ACX_REQUEST_PARAMETERS_INIT_METHOD inizializza uno struct ACX_REQUEST_PARAMETERS con i parametri del metodo ACX.

Sintassi

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

Parametri

Params

Puntatore alla struttura ACX_REQUEST_PARAMETERS utilizzata per archiviare i parametri del metodo.

Set

Un metodo Set ID (GUID).

Id

ID metodo (ULONG) all'interno del metodo Set ID.

Verb

Verbo del metodo ACX da inviare come definito dall'enumerazione ACX_METHOD_VERB .

ItemType

Tipo di elemento ACX_ITEM_TYPE inviato, ad esempio AcxItemTypeCircuit.

ItemId

ID elemento di ItemType, ad esempio l'ID pin se ItemType è un pin.

Args

Un buffer Args facoltativo che contiene parametri aggiuntivi per il metodo specificato. Impostare su Null se non presente.

ArgsCb

Conteggio in byte (dimensioni) del buffer Args. Impostare su 0 se il campo Args non viene utilizzato.

Result

Buffer dei risultati facoltativo per il vecchio risultato dell'operazione. Impostare su Null se non è presente o se *SendMethod deve allocarlo quando ResultCb non è zero. Il chiamante è responsabile della liberazione del buffer allocato.

ResultCb

Conteggio in byte (dimensioni) del buffer dei risultati. Impostare su 0 se Result non viene utilizzato.

Valore restituito

nessuno

Osservazioni

Esempio

Di seguito è riportato un esempio di utilizzo.

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

Requisiti di ACX

Versione minima di ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.

Requisiti

Requisito	Valore
Intestazione	acxrequest.h

Vedi anche

[acxrequest.h header] (index.md)

Condividi tramite