Share via

OID_NDK_SET_STATE

  • Artigo

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

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

Comentários

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

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

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

    1. Chame NdisOpenConfigurationEx com o identificador NDIS que a função NdisMRegisterMiniportDriver retornou quando o driver de miniporto foi inicializado. Para obter mais informações sobre como chamar NdisOpenConfigurationEx, consulte Lendo o Registro em um Driver de Miniporto NDIS 6.0.

    2. Chame NdisReadConfiguration, passando:

      • "*NetworkDirect" para o parâmetro Keyword

      • NdisParameterInteger para o parâmetro ParameterType

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

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

Nota Um driver de miniporto compatível com NDK nunca deve chamar NdisMNetPnPEvent do contexto de sua função MiniportOidRequest , pois isso pode causar um deadlock. Em vez disso, ele deve chamar NdisMNetPnPEvent de algum outro contexto ou enfileirar um item de trabalho.

Uma função MiniportOidRequest do 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 driver não deve retornar NDIS_STATUS_PENDING.

Requisitos

Cliente mínimo com suporte

Nenhum compatível

Servidor mínimo com suporte

Windows Server 2012

Versão

Com suporte no NDIS 6.30 e posterior.

Cabeçalho

 Ntddndis.h (inclua Ndis.h)

Confira também

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER

OID_NDK_SET_STATE