Freigeben über

AcxTargetElementFormatRequestForMethod-Funktion (acxtargets.h)

  • Artikel

Die AcxTargetElementFormatRequestForMethod-Funktion formatiert eine WDFREQUEST als ACX-Methodenanforderung, die für das angegebene Elementziel verwendet werden soll.

Syntax

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

Parameter

TargetElement

Ein ACXTARGETELEMENT-Handle. 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

Dieser Beispielcode zeigt die Verwendung des 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);

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