Sdílet prostřednictvím

OID_NDK_SET_STATE

  • Článek

Jako požadavek na sadu používají ovladače NDIS a nadlimitní ovladače OID_NDK_SET_STATE OID k nastavení stavu funkce NDK adaptéru miniportu.

Ovladače miniportu NDIS 6.30 a novější, které poskytují služby NDK, musí tento identifikátor OID podporovat. Jinak je tento identifikátor OID nepovinný.

Poznámky

NDIS tento identifikátor OID vydává s InformationBuffer člen struktury NDIS_OID_REQUEST odkazující na BOOLEAN a InformationBufferLength člen equal to sizeof(BOOLEAN).

  • Pokud je hodnota BOOLEANTRUE a *NetworkDirect hodnota klíčového slova je nenulová, musí být povolena funkce NDK miniportu adaptéru.

    Ovladač miniportu může číst hodnotu klíčového slova *NetworkDirect následujícím způsobem:

    1. Volání NdisOpenConfigurationEx pomocí popisovače NDIS, který NdisMRegisterMiniportDriver funkce vrácena při inicializaci ovladače miniportu. Další informace o volání NdisOpenConfigurationExnaleznete v tématu čtení registru v ovladači miniportu NDIS 6.0.

    2. Volání NdisReadConfiguration, předávání:

      • "*NetworkDirect" pro parametr klíčového slova

      • NdisParameterInteger pro parametr ParameterType

  • Pokud je hodnota BOOLEANFALSE, musí být funkce sady NDK adaptéru miniportu zakázaná.

Pokud chcete povolit nebo zakázat jeho funkce NDK, miniport ovladač MiniportOidRequest zpětné volání by měl postupovat podle kroků v Povolení a zakázání funkce NDK.

Poznámka ovladač miniportu podporující NDK nikdy nesmí volat NdisMNetPnPEvent z kontextu jeho MiniportOidRequest funkce, protože by to mohlo způsobit zablokování. Místo toho by měl volat NdisMNetPnPEvent z jiného kontextu nebo zařadí pracovní položku do fronty.

Funkce miniportu s podporou NDK MiniportOidRequest musí vrátit STATUS_SUCCESS pro požadavek OID_NDK_SET_STATE identifikátoru, pokud nedojde k chybě. Ovladač nesmí vracet NDIS_STATUS_PENDING.

Požadavky

Minimální podporovaný klient

Žádné se nepodporuje.

Minimální podporovaný server

Windows Server 2012

Verze

Podporováno v NDIS 6.30 a novějších verzích.

Záhlaví

 Ntddndis.h (včetně Ndis.h)

Viz také

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER