AcxTargetElementFormatRequestForMethod, fonction (acxtargets.h)

  • Article

La fonction AcxTargetElementFormatRequestForMethod met en forme une WDFREQUEST en tant que demande 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

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

Request

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

Params

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

Valeur retournée

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

Remarques

Un WDFREQUEST est un pilote créé des demandes d’E/S. Les pilotes basés sur l’infrastructure traitent chaque demande d’E/S en appelant des méthodes d’objet de requête d’infrastructure. Pour plus d’informations, consultez Objets de requête d’infrastructure.

Exemple

Cet exemple de code montre l’utilisation de 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 ACX minimale : 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 acxtargets.h
IRQL PASSIVE_LEVEL

Voir aussi