OID_NDK_SET_STATE
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:
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.
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) |