AcxTargetPinFormatRequestForMethod, fonction (acxtargets.h)

  • Article

La fonction AcxTargetPinFormatRequestForMethod met en forme une fonction WDFREQUEST en tant que demande de méthode ACX à utiliser sur la cible de broche spécifiée.

Syntaxe

NTSTATUS AcxTargetPinFormatRequestForMethod(
  ACXTARGETPIN            TargetPin,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

Paramètres

TargetPin

Objet ACXTARGETPIN existant. 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

...
    _In_    ACXTARGETCIRCUIT TargetCircuit,
    _In_    ULONG            TargetPinId
    )

    NTSTATUS                    status;
    WDFREQUEST                  req;
    ACX_REQUEST_PARAMETERS      params;
    ACXTARGETPIN                targetPin = NULL;

...

    //
    // Get the target pin obj.
    //
    targetPin = AcxTargetCircuitGetTargetPin(TargetCircuit, TargetPinId);

    //
    // Format a WDF request for the target.
    //
    status = AcxTargetPinFormatRequestForMethod(targetPin, 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