OID_GEN_ISOLATION_PARAMETERS
O NDIS e os drivers sobrepostos emitem uma solicitação de OID (identificador de objeto) de OID_GEN_ISOLATION_PARAMETERS para obter os parâmetros de configuração de várias locações (isolamento) definidos na porta de um adaptador de rede de VM.
Embora cada domínio de roteamento seja configurado separadamente na porta, esse OID retorna parâmetros para todos os domínios de roteamento em uma única consulta.
Um driver sobreposto deve emitir essa OID em duas etapas:
- Consulte o tamanho do buffer necessário, emita a consulta OID com o membro Size do membro Header da estrutura NDIS_ISOLATION_PARAMETERS definido como NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1. (Veja NDIS_STATUS_INVALID_LENGTH abaixo.)
- Emita o OID com um InformationBuffer do tamanho necessário.
Se a solicitação de consulta OID for concluída com êxito, o membro InformationBuffer da estrutura NDIS_OID_REQUEST conterá um ponteiro para um buffer. Esse buffer contém os seguintes dados, na ordem:
Uma ou mais estruturas de NDIS_ROUTING_DOMAIN_ENTRY , uma para cada domínio de roteamento
Uma ou mais estruturas NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY , agrupadas pelo domínio de roteamento
Em cada estrutura NDIS_ROUTING_DOMAIN_ENTRY , o membro FirstIsolationInfoEntryOffset contém o deslocamento do início do buffer de informações OID (ou seja, o início do buffer para o qual o membro InformationBuffer da estrutura NDIS_OID_REQUEST aponta) para o primeiro NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY desse domínio de roteamento. O deslocamento no membro NextIsolationInfoEntryOffset da última estrutura na lista é zero.
Se nenhum parâmetro de configuração de várias locações for definido no adaptador de rede da VM, o driver de miniporto do adaptador de rede definirá os DADOS. QUERY_INFORMATION. Membro BytesWritten da estrutura NDIS_OID_REQUEST como zero e retorna NDIS_STATUS_SUCCESS. Nesse caso, os dados dentro dos DADOS. QUERY_INFORMATION. O membro InformationBuffer não é modificado pelo driver de miniport.
Comentários
Retornar códigos de status
O driver de miniporte do adaptador de rede da VM retorna um dos seguintes códigos status para esta solicitação OID:
| Código de status | Descrição |
|---|---|
NDIS_STATUS_SUCCESS |
A solicitação OID foi concluída com êxito. |
NDIS_STATUS_INVALID_LENGTH |
O comprimento do buffer de informações é muito pequeno para retornar as informações solicitadas. O driver de miniporto do adaptador de rede da VM define os DADOS. METHOD_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer, em bytes, que é necessário. |
NDIS_STATUS_FAILURE |
A solicitação falhou por outros motivos. |
Requisitos
Versão |
Com suporte no NDIS 6.40 e posterior. |
parâmetro |
Ntddndis.h (inclua Ndis.h) |