NdisFSynchronousOidRequest-Funktion (ndis.h)

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

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 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

Diese Funktion gibt dieselben Werte wie NdisDirectOidRequest-zurück, außer, dass NDIS_STATUS_PENDING niemals von dieser Funktion zurückgegeben wird.

Bemerkungen

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 NDIS für die Verwendung mit der synchronen OID-Schnittstelle unterstützt. Die meisten Filtertreiber müssen nicht NdisFSynchronousOidRequestaufrufen.

Filtertreiber dürfen FilterDetach- erst abgeschlossen werden, wenn alle synchronen OID-Anforderungen, die vom Filtertreiber stammen, abgeschlossen sind.

Filtertreiber sind nicht erforderlich, um FilterOidRequestComplete, FilterDirectOidRequestComplete, FilterSynchronousOidRequestoder FilterSynchronousOidRequestComplete, um NdisFSynchronousOidRequestaufzurufen. Wie der Name schon sagt, wird eine synchrone OID-Anforderung immer synchron abgeschlossen, sodass kein asynchroner Rückruf vorhanden ist.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1709
Zielplattform-	Universal
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	<= DISPATCH_LEVEL

Siehe auch

FilterSynchronousOidRequest-

FilterSynchronousOidRequestComplete-

synchrone OID-Anforderungsschnittstelle in NDIS 6.80