AcxTargetCircuitFormatRequestForProperty-Funktion (acxtargets.h)

  • Artikel

AcxTargetCircuitFormatRequestForProperty formatiert eine WDFREQUEST als ACX-Eigenschaftsanforderung, die für das angegebene Leitungsziel verwendet werden soll.

Syntax

NTSTATUS AcxTargetCircuitFormatRequestForProperty(
  ACXTARGETCIRCUIT        TargetCircuit,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

Parameter

TargetCircuit

Ein ACXTARGETCIRCUIT-Handle. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung von ACX-Objekten.

Request

Ein WDFREQUEST-Handle, das unter Zusammenfassung von Frameworkobjekten beschrieben wird. Allgemeine Informationen zu WDF-Anforderungen finden Sie unter Erstellen von Framework-Anforderungsobjekten.

Params

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

Rückgabewert

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

Hinweise

Eine WDFREQUEST ist ein Treiber, der E/A-Anforderungen erstellt hat. Frameworkbasierte Treiber verarbeiten jede E/A-Anforderung durch Aufrufen von Frameworkanforderungsobjektmethoden. Weitere Informationen finden Sie unter Framework-Anforderungsobjekte.

Beispiel


    ACX_REQUEST_PARAMETERS      params;
    WDFREQUEST                  req;
    ACXTARGETCIRCUIT            targetCircuit;

...

    //
    // Format a WDF request as an ACX property request for the ACX circuit target.
    //
    status = AcxTargetCircuitFormatRequestForProperty(targetCircuit, req, &params);

ACX-Anforderungen

ACX-Mindestversion: 1.0

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

Anforderungen

Anforderung Wert
Header acxtargets.h
IRQL PASSIVE_LEVEL

Weitere Informationen