OID_NDK_SET_STATE

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

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

Observações

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

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

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

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

  2. Chame NdisReadConfiguration, passando:

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

     • 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 de NDK, a função de retorno de chamadaMiniportOidRequestdo driver de miniport deve seguir as etapas em Habilitar e desabilitar a funcionalidade do NDK.

Observação Um driver de miniporto compatível com NDK nunca deve chamar NdisMNetPnPEvent do contexto de sua funçãoMiniportOidRequest, 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 deMiniportOidRequestdo driver de miniporto 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

Consulte também

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER