Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A extensão de comutador extensível Hyper-V emite uma solicitação de método OID (identificador de objeto) de OID_SWITCH_PROPERTY_ENUM para obter uma matriz. Essa matriz contém as políticas de comutador provisionadas que correspondem aos critérios especificados. Cada elemento na matriz especifica as propriedades de uma política de comutador extensível.
O InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para um buffer. Esse buffer contém os seguintes dados:
Uma estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS que especifica os parâmetros para a enumeração de política de comutador extensível.
Uma matriz de estruturas NDIS_SWITCH_PROPERTY_ENUM_INFO. Cada uma dessas estruturas contém informações sobre uma política de comutador extensível.
Observação Se a extensão não tiver sido provisionada com instâncias da política de comutador extensível especificada, a extensão definirá o NumProperties membro da estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS como zero e nenhuma estrutura de NDIS_SWITCH_PROPERTY_ENUM_INFO será retornada.
Observações
O OID OID_SWITCH_PROPERTY_ENUM só deve ser emitido quando o comutador extensível Hyper-V tiver concluído a ativação. Consulte Consultando o de Configuração do Comutador Extensível Hyper-V para obter mais detalhes.
Ao contrário das solicitações de consulta OID de OID_SWITCH_PORT_PROPERTY_ENUM, a extensão não precisa chamar nenhuma ReferenceSwitchXxx ou DereferenceSwitchXxx funções quando emite a solicitação OID_SWITCH_PROPERTY_ENUM na pilha do driver de comutador extensível.
Observação Se a extensão receber a solicitação do método OID de OID_SWITCH_PROPERTY_ENUM, ela não deverá concluir a solicitação OID. Em vez disso, ele deve chamar NdisFOidRequest para encaminhar a solicitação OID para baixo na pilha de driver de comutador extensível.
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_PROPERTY_ENUM 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 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS e sua matriz de elementos NDIS_SWITCH_PROPERTY_ENUM_INFO. A borda do miniporto subjacente do comutador extensível define a DATA. METHOD_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_SWITCH_PROPERTY_ENUM_INFO
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS
consultando o de configuração do comutador extensível Hyper-V