Compartilhar via


OID_SWITCH_PARAMETERS

Uma extensão de comutador extensível Hyper-V emite uma solicitação de consulta OID (identificador de objeto) de OID_SWITCH_PARAMETERS para obter os dados de configuração do comutador extensível.

Se a solicitação de consulta OID for concluída com êxito, o InformationBuffer membro da estrutura NDIS_OID_REQUEST conterá um ponteiro para uma estrutura NDIS_SWITCH_PARAMETERS.

Observações

Quando a extensão processa a estrutura de NDIS_SWITCH_PARAMETERS retornada, ela não deve assumir que os vários membros de cadeia de caracteres da estrutura de NDIS_SWITCH_PARAMETERS, como SwitchName, são encerrados em nulo. Os tipos de dados desses membros de cadeia de caracteres são definidos por tipo pela estrutura IF_COUNTED_STRING. A extensão deve determinar o comprimento da cadeia de caracteres do valor do Length membro dessa estrutura.

Observação Se a cadeia de caracteres for terminada em nulo, o membro comprimento não deverá incluir o caractere nulo de encerramento.

Códigos de status de retorno

A borda do miniporto subjacente do comutador extensível conclui a solicitação de consulta OID de OID_SWITCH_PARAMETERS e retorna um dos seguintes códigos de status.

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 a estrutura de OID_SWITCH_PARAMETERS para uma solicitação de consulta OID. A borda do miniporto subjacente do comutador extensível define a DATA. QUERY_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.

NDIS_STATUS_FAILURE

A solicitação falhou por outros motivos.

Requisitos

Versão

Com suporte no NDIS 6.30 e posterior.

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Consulte também


NDIS_OID_REQUEST

NDIS_SWITCH_PARAMETERS

NdisFOidRequest