AcxTargetElementFormatRequestForMethod-Funktion (acxtargets.h)
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 Zusammenfassung der ACX-Objekte.
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 Methodenanforderungsparameterinformationen verwendet wird.
Rückgabewert
Gibt zurück STATUS_SUCCESS
, wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender 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
Dieser Beispielcode zeigt die Verwendung von AcxTargetElementFormatRequestForMethod.
{
ACXTARGETELEMENT targetElement = NULL;
ULONG targetElementId = 0;
ULONG targetElementsCount = AcxTargetCircuitGetElementsCount(TargetCircuit);
arg = elementArg;
result = 0;
targetElement = AcxTargetCircuitGetTargetElement(TargetCircuit, targetElementId);
ACX_REQUEST_PARAMETERS_INIT_METHOD(
¶ms,
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, ¶ms);
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 |