Partager via


fonction ACX_REQUEST_PARAMETERS_INIT_METHOD (acxrequest.h)

La fonction ACX_REQUEST_PARAMETERS_INIT_METHOD initialise un struct ACX_REQUEST_PARAMETERS avec des paramètres de 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

ID set de méthode (GUID).

Id

ID de méthode (ULONG) dans l’ID set de méthode.

Verb

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

ItemType

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

ItemId

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

Args

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

ArgsCb

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

Result

Mémoire tampon de résultat facultative à l’ancien résultat de l’opération. Défini sur Null s’il n’est pas présent ou si *SendMethod doit l’allouer lorsque ResultCb n’est pas égal à zéro. L’appelant est chargé de libérer la mémoire tampon allouée.

ResultCb

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

Valeur de retour

Aucun

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

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence Valeur
d’en-tête acxrequest.h

Voir aussi