Partager via

AcxTargetElementFormatRequestForMethod, fonction (acxtargets.h)

  • Article

La fonction AcxTargetElementFormatRequestForMethod met en forme une fonction WDFREQUEST en tant que requête de méthode ACX à utiliser sur la cible d’élément spécifiée.

Syntaxe

NTSTATUS AcxTargetElementFormatRequestForMethod(
  ACXTARGETELEMENT        TargetElement,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

Paramètres

TargetElement

Handle ACXTARGETELEMENT. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

Request

Handle WDFREQUEST décrit dans Résumé des objets Framework. Pour plus d’informations générales sur les requêtes WDF, consultez Création d’objets de requête framework.

Params

Structure de ACX_REQUEST_PARAMETERS initialisée utilisée pour stocker les informations de paramètre de requête de méthode.

Valeur de retour

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.

Remarques

WdFREQUEST est un pilote créé des requêtes d’E/S. Les pilotes basés sur l’infrastructure traitent chaque requête d’E/S en appelant des méthodes d’objet de requête d’infrastructure. Pour plus d’informations, consultez Framework Request Objects.

Exemple

Cet exemple de code montre l’utilisation d’AcxTargetElementFormatRequestForMethod.


    {
        ACXTARGETELEMENT targetElement          = NULL;
        ULONG            targetElementId        = 0;
        ULONG            targetElementsCount    = AcxTargetCircuitGetElementsCount(TargetCircuit);
        arg     = elementArg;
        result  = 0;

        targetElement = AcxTargetCircuitGetTargetElement(TargetCircuit, targetElementId);       

        ACX_REQUEST_PARAMETERS_INIT_METHOD(
            &params,
            KSMETHODSETID_AcxTestMethod,
            KSMETHOD_ACXELEMENT_TEST_IN2OUT,
            AcxMethodVerbSend,
            AcxItemTypeElement,
            targetElementId,
            &arg, sizeof(arg),      // Value & size
            &result, sizeof(result) // Control & size
            );  

        //
        // Format a WDF request as an ACX method request for the ACX element target.
        //
        status = AcxTargetElementFormatRequestForMethod(targetElement, req, &params);

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 acxtargets.h
IRQL PASSIVE_LEVEL

Voir aussi