Condividi tramite


OID_NDK_SET_STATE

Come richiesta impostata, i driver NDIS e overlying usano l'OID OID_NDK_SET_STATE per impostare lo stato della funzionalità NDK dell'adattatore miniport.

I driver miniport NDIS 6.30 e versioni successive che forniscono servizi NDK devono supportare questo OID. In caso contrario, questo OID è facoltativo.

Osservazioni

NDIS rilascia questo OID con il membro InformationBuffer della struttura NDIS_OID_REQUEST che punta a un BOOLEAN e InformationBufferLength membro uguale a sizeof(BOOLEAN).

  • Se il valore BOOLEAN è TRUE e il valore della parola chiave *NetworkDirect è diverso da zero, è necessario abilitare la funzionalità NDK dell'adattatore miniport.

    Il driver miniport può leggere il valore della parola chiave *NetworkDirect eseguendo le operazioni seguenti:

    1. Chiamare NdisOpenConfigurationEx con l'handle NDIS che la funzione NdisMRegisterMiniportDriver restituita quando è stato inizializzato il driver miniport. Per altre informazioni sulla chiamata di NdisOpenConfigurationEx, vedere Lettura del Registro di sistema in un driver miniport NDIS 6.0.

    2. Chiamare NdisReadConfiguration, passando:

      • "*NetworkDirect" per il parametro parola chiave

      • NdisParameterInteger per il parametro ParameterType

  • Se il valore BOOLEAN è FALSE, è necessario disabilitare la funzionalità NDK dell'adattatore miniport.

Per abilitare o disabilitare la funzionalità NDK, il driver miniport MiniportOidRequest funzione di callback deve seguire i passaggi descritti in Abilitazione e disabilitazione della funzionalità NDK.

Nota Un driver miniport con supporto per NDK non deve mai chiamare NdisMNetPnPEvent dal contesto della relativa funzione MiniportOidRequest, perché ciò potrebbe causare un deadlock. Deve invece chiamare NdisMNetPnPEvent da un altro contesto o accodare un elemento di lavoro.

La funzioneMiniportOidRequest di un driver con supporto per NDK deve restituire STATUS_SUCCESS per una richiesta OID OID_NDK_SET_STATE a meno che non si verifichi un errore. Il driver non deve restituire NDIS_STATUS_PENDING.

Fabbisogno

Client minimo supportato

Nessuna supportata

Server minimo supportato

Windows Server 2012

Versione

Supportato in NDIS 6.30 e versioni successive.

Intestazione

Ntddndis.h (include Ndis.h)

Vedere anche

NDIS_OID_REQUEST

NdisMNetPnPEvent di

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER

OID_NDK_SET_STATE