OID_SWITCH_PORT_PROPERTY_ENUM

Artigo
06/15/2023

A extensão de comutador extensível do Hyper-V emite uma solicitação de método OID (identificador de objeto) de OID_SWITCH_PORT_PROPERTY_ENUM para obter uma matriz. Essa matriz contém as políticas de porta provisionadas que correspondem aos critérios especificados. Cada elemento na matriz especifica as propriedades de uma política para uma porta de comutador extensível especificada.

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_PORT_PROPERTY_ENUM_PARAMETERS que especifica os parâmetros para a enumeração de política de uma porta especificada.
Uma matriz de estruturas de NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO . Cada uma dessas estruturas contém informações sobre as propriedades de uma política de porta de comutador extensível.

Nota Se o membro NumProperties da estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS for definido como zero, nenhuma estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO será retornada.

Comentários

Antes de emitir uma solicitação de método OID de OID_SWITCH_PORT_PROPERTY_ENUM, a extensão de comutador extensível deve seguir estas diretrizes:

A extensão só pode emitir a solicitação de OID_SWITCH_PORT_PROPERTY_ENUM após a borda do protocolo do comutador extensível emitir uma solicitação de OID_SWITCH_PORT_CREATE e antes de emitir uma solicitação de OID_SWITCH_PORT_TEARDOWN .
A extensão deve chamar ReferenceSwitchPort antes de chamar NdisFOidRequest para emitir a solicitação OID_SWITCH_PORT_PROPERTY_ENUM. Isso garante que a porta especificada não será excluída até que a solicitação OID seja concluída.

Depois que a solicitação OID for concluída, a extensão deverá chamar DereferenceSwitchPort. A extensão deve chamar essa função independentemente de a solicitação OID ter sido concluída com NDIS_STATUS_SUCCESS.

O OID_SWITCH_PORT_PROPERTY_ENUM OID só deve ser emitido quando a opção 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.

Nota Se a extensão receber a solicitação de método OID de OID_SWITCH_PORT_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_PORT_PROPERTY_ENUM e retorna o código status a seguir.