Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A extensão de switch extensível Hyper-V emite uma solicitação de método de identificador de objeto (OID) de OID_SWITCH_PROPERTY_ENUM para obter uma matriz. Essa matriz contém as políticas de switch provisionadas que correspondem aos critérios especificados. Cada elemento na matriz especifica as propriedades de uma política de switch extensível.
O InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para um buffer. Este buffer contém os seguintes dados:
Uma estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS que especifica os parâmetros para a enumeração de diretiva de switch extensível.
Uma série de estruturas NDIS_SWITCH_PROPERTY_ENUM_INFO. Cada uma dessas estruturas contém informações sobre uma política de switch extensível.
Observação Se a extensão não tiver sido provisionada com instâncias da diretiva de switch extensível especificada, a extensão definirá o NumProperties membro da estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS como zero e nenhuma estrutura NDIS_SWITCH_PROPERTY_ENUM_INFO será retornada.
Comentários
O OID_SWITCH_PROPERTY_ENUM OID só deve ser emitido quando o switch 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 do OID_SWITCH_PORT_PROPERTY_ENUM, a extensão não precisa chamar nenhum ReferenceSwitchXxx ou funções de DereferenceSwitchXxx quando emite a solicitação de OID_SWITCH_PROPERTY_ENUM na pilha de driver de switch extensível.
Nota Se a extensão receber a solicitação de 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 switch extensível.
Códigos de status de retorno
A borda de miniporta subjacente do switch 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 de miniporta subjacente do switch extensível define o DATA. METHOD_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário. |
NDIS_STATUS_FAILURE |
O pedido foi rejeitado por outros motivos. |
Requerimentos
Versão |
Suportado no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |
Ver também
NDIS_SWITCH_PROPERTY_ENUM_INFO
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS
Consultando o de configuração do comutador extensível Hyper-V