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 |