NdisFDirectOidRequest-Funktion (ndis.h)

Artikel
02/29/2024

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 das Handle in einem Aufruf der FilterAttach-Funktion an den Filtertreiber übergeben.

[in] OidRequest

Ein Zeiger auf eine NDIS_OID_REQUEST-Struktur , die den Vorgang angibt, der mit einem angegebenen 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 NdisDirectOidRequest-Funktion .

Hinweise

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 von NDIS für die Verwendung mit der direkten OID-Schnittstelle unterstützt werden. 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 NdisFDirectOidRequest aufrufen.

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_PENDING zurückgibt, ruft NDIS die FilterDirectOidRequestComplete-Funktion auf, nachdem die zugrunde liegenden Treiber die OID-Anforderung abgeschlossen haben. Ein Treiber, der NdisFDirectOidRequest aufruft, muss die FilterDirectOidRequestComplete-Funktion registrieren.

Ein Treiber kann NdisFDirectOidRequest aufrufen, wenn er sich im Status "Neustart", " Wird ausgeführt", " Angehalten" oder " Angehalten" befindet.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.1 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL