WdfRequestGetRequestorMode-Funktion (wdfrequest.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WdfRequestGetRequestorMode Methode gibt den Prozessorzugriffsmodus des Absenders einer angegebenen E/A-Anforderung zurück.

Syntax

KPROCESSOR_MODE WdfRequestGetRequestorMode(
  [in] WDFREQUEST Request
);

Parameter

[in] Request

Ein Handle zu einem Framework-Anforderungsobjekt.

Rückgabewert

WdfRequestGetRequestorMode gibt KernelMode- zurück, wenn der Absender der E/A-Anforderung im Kernelmodus ausgeführt wird. Andernfalls gibt diese Methode UserMode-zurück. Die KernelMode und UserMode Konstanten werden in wdm.h-definiert.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Weitere Informationen zu WdfRequestGetRequestorMode-finden Sie unter Abrufen von Informationen zu einer E/A-Anforderung.

Beispiele

Das folgende Codebeispiel stammt aus dem NDISProt Beispieltreiber. In diesem Beispiel wird überprüft, ob die E/A-Anforderung von einer Benutzermodusanwendung stammt.

//
// To prevent applications from sending packets with spoofed MAC address,
// perform the following check to make sure the source address 
// in the packet is the same as the current MAC address of the NIC.
//
if ((WdfRequestGetRequestorMode(Request) == UserMode) && 
    !NPROT_MEM_CMP(pEthHeader->SrcAddr, pOpenContext->CurrentAddress, NPROT_MAC_ADDR_LEN))
{
    DEBUGP(DL_WARN, ("Write: Failing with invalid Source address"));
    NtStatus = STATUS_INVALID_PARAMETER;
    break;
}

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfrequest.h (include Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Freigeben über