OID_SWITCH_PROPERTY_ENUM
A extensão de comutador extensível do 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 membro InformationBuffer 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 extensível de política de comutador.
Uma matriz de estruturas de NDIS_SWITCH_PROPERTY_ENUM_INFO . Cada uma dessas estruturas contém informações sobre uma política de comutador extensível.
Nota 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 membro NumProperties da estrutura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS como zero e nenhuma estrutura de NDIS_SWITCH_PROPERTY_ENUM_INFO será retornada.
Comentários
O OID_SWITCH_PROPERTY_ENUM OID só deve ser emitido quando o comutador extensível do Hyper-V tiver concluído a ativação. Consulte Consultando a Configuração do Comutador Extensível do 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 função ReferenceSwitchXxx ouDereferenceSwitchXxx quando emite o OID_SWITCH_PROPERTY_ENUM solicitar a pilha do driver de comutador 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 do driver de comutador extensível.
Retornar códigos de status
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 o DATA. METHOD_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) |
Confira também
NDIS_SWITCH_PROPERTY_ENUM_INFO
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS
Consultando a configuração de comutador extensível do Hyper-V