Freigeben über

AcxTargetPinFormatRequestForMethod-Funktion (acxtargets.h)

  • Artikel

Die AcxTargetPinFormatRequestForMethod Funktionsfunktion formatiert eine WDFREQUEST als ACX-Methodenanforderung, die für das angegebene Pinziel verwendet werden soll.

Syntax

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

Parameter

TargetPin

Ein vorhandenes ACXTARGETPIN-Objekt. Weitere Informationen zu ACX-Objekten finden Sie unter Summary of ACX Objects.

Request

Ein WDFREQUEST-Handle, das in Summary of Framework Objectsbeschrieben wird. Allgemeine Informationen zu WDF-Anforderungen finden Sie unter Creating Framework Request Objects.

Params

Eine initialisierte ACX_REQUEST_PARAMETERS Struktur, die zum Speichern von Methodenanforderungsparameterinformationen verwendet wird.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

Ein WDFREQUEST ist ein Treiber, der E/A-Anforderungen erstellt hat. Frameworkbasierte Treiber verarbeiten jede E/A-Anforderung durch Aufrufen von Framework-Anforderungsobjektmethoden. Weitere Informationen finden Sie unter Framework Request Objects.

Beispiel

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

ACX-Anforderungen

Mindestens ACX-Version: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header- acxtargets.h
IRQL- PASSIVE_LEVEL

Siehe auch