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.

Commenti

NDIS genera questo OID con il membro InformationBuffer della struttura NDIS_OID_REQUEST che punta a un membro BOOLEAN e InformationBufferLength 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 restituito dalla funzione NdisMRegisterMiniportDriver quando è stato inizializzato il driver miniport. Per altre informazioni sulla chiamata a 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, la funzione di callback del driver miniportoidRequest deve seguire la procedura descritta in Abilitazione e disabilitazione della funzionalità NDK.

Nota Un driver miniport compatibile con NDK non deve mai chiamare NdisMNetPnPEvent dal contesto della funzione MiniportOidRequest , perché in questo modo potrebbe causare un deadlock. Deve invece chiamare NdisMNetPnPEvent da un altro contesto o accodare un elemento di lavoro.

La funzione MiniportOidRequest 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.

Requisiti

Vedi anche

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER

OID_NDK_SET_STATE