Compartilhar via


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:

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_OID_REQUEST

NDIS_SWITCH_PROPERTY_ENUM_INFO

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS

Consultando a configuração de comutador extensível do Hyper-V