WdfFdoInitSetFilter-Funktion (wdffdo.h)

[Gilt für KMDF und UMDF]

Die WdfFdoInitSetFilter--Methode identifiziert den aufrufenden Treiber als übergeordneter oder niedrigerer Filtertreiberfür ein angegebenes Gerät.

Syntax

VOID WdfFdoInitSetFilter(
  [in] PWDFDEVICE_INIT DeviceInit
);

Die Parameter

[in] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT Struktur, die der Treiber aus seiner EvtDriverDeviceAdd Rückruffunktion abgerufen hat.

Rückgabewert

Nichts

Bemerkungen

Filtertreiber verarbeiten in der Regel einige E/A-Anforderungen, aber sie übergeben einfach die meisten Anforderungen an den nächsten Treiber im Treiberstapel. Wenn das Framework eine Anforderung für eines ihrer Treibergeräte empfängt und der Treiber keine E/A-Warteschlange zum Empfangen von Anforderungen erstellt hat, die dem Anforderungstyp entsprechen, hängt die Art und Weise, wie das Framework die Anforderung verarbeitet, davon ab, ob der Treiber WdfFdoInitSetFilteraufgerufen hat:

• Wenn ein Treiber WdfFdoInitSetFilteraufruft, leitet das Treiberframework die Anforderung an den nächsten Treiber weiter.
• Wenn ein Treiber WdfFdoInitSetFilternicht aufruft, schließt das Framework die Anforderung mit dem Statuswert STATUS_INVALID_DEVICE_REQUEST ab.

Der Treiber muss WdfFdoInitSetFilter- aufrufen, bevor WdfDeviceCreateaufgerufen wird. Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object. Darüber hinaus muss der Treiber WdfFdoInitSetFilter- aufrufen, bevor er von seiner EvtDriverDeviceAdd Rückruffunktion zurückgibt.

Weitere Informationen zu WdfFdoInitSetFilter-finden Sie unter Erstellen von Geräteobjekten in einem Filtertreiber-, Erstellen von E/A-Warteschlangen und Weiterleitung von E/A-Anforderungen.

Beispiele

Im folgenden Codebeispiel wird der aufrufende Treiber als Filtertreiber für das angegebene Gerät identifiziert.

WdfFdoInitSetFilter(DeviceInit);

Anforderungen

Siehe auch

WDFDEVICE_INIT