OID_NDK_SET_STATE
Als Set-Anforderung verwenden NDIS und übergeordnete Treiber die OID_NDK_SET_STATE OID, um den Status der NDK-Funktionalität des Miniportadapters festzulegen.
Miniporttreiber von NDIS 6.30 und höher, die NDK-Dienste bereitstellen, müssen diese OID unterstützen. Andernfalls ist diese OID optional.
Bemerkungen
NDIS gibt diese OID mit dem InformationBuffer-Member der NDIS_OID_REQUEST-Struktur aus, der auf ein BOOLEAN - und InformationBufferLength-Member gleich sizeof(BOOLEAN) verweist.
Wenn der BOOLESCHE Wert TRUE und *NetworkDirect Schlüsselwort (keyword) Wert ungleich null ist, muss die NDK-Funktionalität des Miniportadapters aktiviert sein.
Der Miniporttreiber kann den Wert *NetworkDirect Schlüsselwort (keyword) wie folgt lesen:
Rufen Sie NdisOpenConfigurationEx mit dem NDIS-Handle auf, das von der NdisMRegisterMiniportDriver-Funktion zurückgegeben wurde, als der Miniporttreiber initialisiert wurde. Weitere Informationen zum Aufrufen von NdisOpenConfigurationEx finden Sie unter Lesen der Registrierung in einem NDIS 6.0-Miniport-Treiber.
Rufen Sie NdisReadConfiguration auf, und übergeben Sie Folgendes:
"*NetworkDirect" für den Schlüsselwortparameter
NdisParameterInteger für den ParameterType-Parameter
Wenn der BOOLESCHE Wert FALSE ist, muss die NDK-Funktionalität des Miniportadapters deaktiviert sein.
Zum Aktivieren oder Deaktivieren der NDK-Funktionalität sollte die MiniportOidRequest-Rückruffunktion des Miniport-Treibers die Schritte unter Aktivieren und Deaktivieren der NDK-Funktionalität ausführen.
Hinweis Ein NDK-fähiger Miniporttreiber darf NdisMNetPnPEvent niemals aus dem Kontext seiner MiniportOidRequest-Funktion aufrufen, da dies zu einem Deadlock führen kann. Stattdessen sollte NdisMNetPnPEvent aus einem anderen Kontext aufgerufen oder ein Arbeitselement in die Warteschlange gestellt werden.
Die MiniportOidRequest-Funktion eines NDK-fähigen Miniporttreibers muss STATUS_SUCCESS für eine OID_NDK_SET_STATE OID-Anforderung zurückgeben, es sei denn, es tritt ein Fehler auf. Der Treiber darf keine NDIS_STATUS_PENDING zurückgeben.
Anforderungen
Unterstützte Mindestversion (Client) |
Nicht unterstützt |
Unterstützte Mindestversion (Server) |
Windows Server 2012 |
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |