WdfRequestGetRequestorMode-Funktion (wdfrequest.h)

  • Artikel

[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 für ein Frameworkanforderungsobjekt.

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 Konstanten KernelMode und UserMode sind in wdm.h definiert.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

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 nach einer gültigen MAC-Adresse gesucht, wenn 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 Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfrequest.h (include Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)