OID_NDK_SET_STATE

Como uma solicitação definida, o NDIS e os drivers sobrepostos usam o OID_NDK_SET_STATE OID para definir o estado da funcionalidade NDK do adaptador de miniporta.

Os drivers de miniporta NDIS 6.30 e posteriores que fornecem serviços NDK devem oferecer suporte a esse OID. Caso contrário, este OID é opcional.

Comentários

O NDIS emite esse OID com o InformationBuffer membro da estrutura NDIS_OID_REQUEST apontando para um BOOLEAN e membro InformationBufferLength igual a sizeof(BOOLEAN).

• Se o valor de BOOLEAN for TRUE e o valor da palavra-chave *NetworkDirect for diferente de zero, a funcionalidade NDK do adaptador de miniporta deverá ser habilitada.

  O driver de miniporta pode ler o *NetworkDirect valor da palavra-chave fazendo o seguinte:

  1. Chame NdisOpenConfigurationEx com o identificador NDIS que a função NdisMRegisterMiniportDriver retornou quando o driver de miniporta foi inicializado. Para obter mais informações sobre como chamar NdisOpenConfigurationEx, consulte Reading the Registry in an NDIS 6.0 Miniport Driver.

  2. Chame NdisReadConfiguration, passando:

     • "*NetworkDirect" para o parâmetro palavra-chave

     • NdisParameterInteger para o parâmetro ParameterType

• Se o valor BOOLEAN for FALSE, a funcionalidade NDK do adaptador de miniporta deverá ser desabilitada.

Para habilitar ou desabilitar sua funcionalidade NDK, a função de retorno de chamada MiniportOidRequest do driver de miniporta deve seguir as etapas em Habilitando e desabilitando a funcionalidade NDK.

Nota Um driver de miniporta compatível com NDK nunca deve chamar NdisMNetPnPEvent do contexto de sua funçãoMiniportOidRequest, porque isso pode causar um impasse. Em vez disso, ele deve chamar NdisMNetPnPEvent de algum outro contexto ou enfileirar um item de trabalho.

A função deMiniportRequestde um driver de miniporta compatível com NDK deve retornar STATUS_SUCCESS para uma solicitação OID OID_NDK_SET_STATE, a menos que ocorra uma falha. O condutor não deve regressar NDIS_STATUS_PENDING.

Requerimentos

Ver também

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER