Manipulando consultas em um driver de miniporta wan coNDIS
Este tópico fornece uma visão geral dos requisitos para lidar com consultas em um driver de miniporta da WAN do CoNDIS. Um driver de camada superior chama NdisCoOidRequest com uma solicitação de consulta para determinar as funcionalidades específicas da WAN e as status atuais de um driver de miniporta wan coNDIS e a NIC do driver de miniporto.
Depois que o driver intermediário NDISWAN encaminha a solicitação de consulta, o NDIS chama a função MiniportCoOidRequest do driver de miniport. Em um driver de miniporto de WAN coNDIS, essa função é a mesma que em qualquer driver de miniporto orientado a conexão, exceto que o driver de miniporto wan coNDIS dá suporte a objetos wan coNDIS.
Se o driver de miniporta wan coNDIS concluir MiniportCoOidRequest de forma assíncrona retornando um status de NDIS_STATUS_PENDING, ele deverá concluir a consulta mais tarde chamando NdisCoOidRequestComplete.
Quando o NDIS chama MiniportCoOidRequest, o NDIS passa um ponteiro para a estrutura NDIS_OID_REQUEST que contém o OID da consulta e um buffer para manter as informações recuperadas do driver de miniporto. O driver de miniporta controla esse buffer até que a solicitação seja concluída. Se o número de bytes especificado no membro InformationBufferLength do NDIS_OID_REQUEST for insuficiente para as informações necessárias para o OID, o driver de miniporto deverá falhar na solicitação de consulta e definir o membro BytesNeeded de NDIS_OID_REQUEST para o número de bytes exigidos pelo OID.
Nenhuma outra solicitação será enviada ao driver de miniporto WAN específico até que a solicitação de consulta atual seja concluída.
A tabela a seguir resume os OIDs usados para obter ou definir características operacionais para drivers de miniporta wan coNDIS.
Nome | Opcional ou Obrigatório |
---|---|
OID_WAN_CO_GET_INFO Obtenha informações sobre VCs (conexões virtuais). | Obrigatório |
OID_WAN_CO_GET_LINK_INFO Obter informações sobre uma VC. | Obrigatório |
OID_WAN_CO_GET_STATS_INFO Obter informações de estatísticas para uma VC. | Opcional |
Um driver de miniporta de WAN coNDIS pode dar suporte a todos os Objetos Gerais do NDIS. Para saber mais sobre como definir informações em um driver de miniporta coNDIS, consulte Consulta ou configuração de informações.