NdisFDirectOidRequest-Funktion (ndis.h)

Artikel
02/07/2025

Filtertreiber rufen die NdisFDirectOidRequest Funktion auf, um eine direkte OID-Anforderung an zugrunde liegende Treiber weiterzuleiten oder eine solche Anforderung zu erstellen.

Syntax

NDIS_STATUS NdisFDirectOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

Parameter

[in] NdisFilterHandle

Ein NDIS-Handle, das ein Filtermodul identifiziert. NDIS hat den Handle an den Filtertreiber in einem Aufruf der FilterAttach--Funktion übergeben.

[in] OidRequest

Ein Zeiger auf eine NDIS_OID_REQUEST Struktur, die den Vorgang angibt, der mit einem bestimmten OID_Xxx--Code angefordert wird. Die Struktur kann eine OID-Abfrage, einen Satz oder eine Methodenanforderung angeben.

Rückgabewert

Eine Liste der möglichen Rückgabewerte finden Sie in der funktion NdisDirectOidRequest.

Bemerkungen

Die NdisFDirectOidRequest Funktion kann nicht für allgemeine OID-Anforderungen verwendet werden. Verwenden Sie für allgemeine OID-Anforderungen stattdessen die NdisFOidRequest Funktion. NdisFDirectOidRequest- kann nur für OIDs verwendet werden, die NDIS für die Verwendung mit der direkten OID-Schnittstelle unterstützt. Beispielsweise können die folgenden OIDs verwendet werden:

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA

Filtertreiber können direkte OID-Anforderungen an zugrunde liegende Treiber erstellen, indem sie NdisFDirectOidRequestaufrufen.

Filtertreiber können auch direkte OID-Anforderungen filtern, die von übermäßigen Treibern stammen. NDIS ruft die FilterDirectOidRequest--Funktion auf, um jede solche Anforderung zu verarbeiten.

Wenn NdisFDirectOidRequestNDIS_STATUS_PENDINGzurückgibt, ruft NDIS die FilterDirectOidRequestComplete-funktion auf, nachdem die zugrunde liegenden Treiber die OID-Anforderung abgeschlossen haben. Ein Treiber, der NdisFDirectOidRequest- aufruft, muss die funktion FilterDirectOidRequestComplete registrieren.

Ein Treiber kann NdisFDirectOidRequest- aufrufen, wenn er sich im zustand "Restarting, Running, Pausingoder Angehalten Zustand befindet.

Die direkte OID-Anforderungsschnittstelle ähnelt der allgemeinen OID-Anforderungsschnittstelle. Weitere Informationen zum Ausgeben allgemeiner Anforderungen finden Sie unter NdisFOidRequest.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.1 und höher.
Zielplattform-	Desktop
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	<= DISPATCH_LEVEL