NdisFSynchronousOidRequest-Funktion (ndis.h)

Artikel
08/07/2023

Filtertreiber rufen die NdisFSynchronousOidRequest-Funktion auf, um eine neue synchrone OID-Anforderung zu erstellen und an zugrunde liegende Treiber ausstellen zu können.

Diese Funktion wird in NDIS 6.81 und höher unterstützt.

Syntax

NDIS_STATUS NdisFSynchronousOidRequest(
  [in] NDIS_HANDLE      NdisFilterModuleHandle,
  [in] NDIS_OID_REQUEST *OidRequest
);

Parameter

[in] NdisFilterModuleHandle

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 bestimmten OID_Xxx Code angefordert wird. Die -Struktur kann eine OID-Abfrage, einen Satz oder eine Methodenanforderung angeben.

Rückgabewert

Diese Funktion gibt die gleichen Werte wie NdisDirectOidRequest zurück, mit der Ausnahme, dass NDIS_STATUS_PENDING niemals von dieser Funktion zurückgegeben wird.

Hinweise

Die NdisFSynchronousOidRequest-Funktion kann nicht für allgemeine OID-Anforderungen verwendet werden. Verwenden Sie für allgemeine OID-Anforderungen stattdessen die NdisFOidRequest-Funktion . NdisFSynchronousOidRequest kann nur für OIDs verwendet werden, die von NDIS für die Verwendung mit der synchronen OID-Schnittstelle unterstützt werden. Die meisten Filtertreiber müssen NdisFSynchronousOidRequest nicht aufrufen.

Filtertreiber dürfen FilterDetach erst abschließen, wenn synchrone OID-Anforderungen, die vom Filtertreiber stammen, abgeschlossen sind.

Filtertreiber sind nicht erforderlich, um FilterOidRequestComplete, FilterDirectOidRequestComplete, FilterSynchronousOidRequest oder FilterSynchronousOidRequestComplete zu implementieren, um NdisFSynchronousOidRequest aufzurufen. Wie der Name schon sagt, wird eine synchrone OID-Anforderung immer synchron abgeschlossen, sodass kein asynchroner Rückruf erfolgt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709
Zielplattform	Universell
Header	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

Synchrone OID-Anforderungsschnittstelle in NDIS 6.80

Freigeben über