OID_SWITCH_PARAMETERS
Uma extensão de comutador extensível do 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 membro InformationBuffer da estrutura NDIS_OID_REQUEST conterá um ponteiro para uma estrutura NDIS_SWITCH_PARAMETERS .
Comentários
Quando a extensão processa a estrutura de NDIS_SWITCH_PARAMETERS retornada, não deve pressupor que os vários membros de cadeia de caracteres da estrutura NDIS_SWITCH_PARAMETERS , como SwitchName, sejam encerrados em nulo. Os tipos de dados para esses membros de cadeia de caracteres são definidos pelo tipo pela estrutura IF_COUNTED_STRING . A extensão deve determinar o comprimento da cadeia de caracteres do valor do membro Length dessa estrutura.
Nota Se a cadeia de caracteres for terminada em nulo, o membro Length não deverá incluir o caractere nulo de terminação.
Retornar códigos de status
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 OID_SWITCH_PARAMETERS para uma solicitação de consulta OID. A borda do miniporto subjacente do comutador extensível define o DATA. QUERY_INFORMATION. Membro BytesNeeded 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) |