fonction ACX_REQUEST_PARAMETERS_INIT_METHOD (acxrequest.h)

Article
02/22/2024

La fonction ACX_REQUEST_PARAMETERS_INIT_METHOD initialise un struct de ACX_REQUEST_PARAMETERS avec les paramètres de la méthode ACX.

Syntaxe

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

Paramètres

Params

Pointeur vers ACX_REQUEST_PARAMETERS structure utilisée pour stocker les paramètres de méthode.

Set

Une méthode Set ID (GUID).

Id

ID de méthode (ULONG) dans la méthode Set ID.

Verb

Verbe de méthode ACX à envoyer tel que défini par l’énumération ACX_METHOD_VERB .

ItemType

Le ACX_ITEM_TYPE type d’élément envoyé, par exemple AcxItemTypeCircuit.

ItemId

ID d’élément de l’ÉlémentType, par exemple l’ID de broche si l’ItemType est une broche.

Args

Mémoire tampon Args facultative contenant des paramètres supplémentaires pour la méthode spécifiée. Définissez sur null s’il n’est pas présent.

ArgsCb

Nombre en octets (taille) de la mémoire tampon Args. Définissez sur 0 si le champ Args n’est pas utilisé.

Result

Mémoire tampon de résultat facultative pour anciennement le résultat de l’opération. Définissez la valeur null si elle n’est pas présente ou si *SendMethod doit l’allouer lorsque ResultCb n’est pas égal à zéro. L’appelant est responsable de libérer la mémoire tampon allouée.

ResultCb

Nombre en octets (taille) de la mémoire tampon de résultat. Défini sur 0 si Result n’est pas utilisé.

Valeur de retour

None

Remarques

Exemple

L’exemple d’utilisation est illustré ci-dessous.

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

Configuration requise d’ACX

Version minimale d’ACX : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise	Valeur
En-tête	acxrequest.h

Voir aussi

[en-tête acxrequest.h] (index.md)

Partager via