OID_SWITCH_PORT_PROPERTY_ENUM

Artigo
03/13/2025

A extensão de comutador extensível 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 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_PORT_PROPERTY_ENUM_PARAMETERS que especifica os parâmetros para a enumeração de política de uma porta especificada.
Uma matriz de estruturas 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.

Observação Se o NumProperties membro da estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS estiver definido como zero, nenhuma estrutura de NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO será retornada.

Observações

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 OID_SWITCH_PORT_PROPERTY_ENUM depois que a borda do protocolo do comutador extensível emite uma solicitação de OID_SWITCH_PORT_CREATE e antes de emitir uma solicitação OID_SWITCH_PORT_TEARDOWN.
A extensão deve chamar ReferenceSwitchPort antes de chamar NdisFOidRequest para emitir a solicitação de 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 OID_SWITCH_PORT_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.

Observação 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 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_PORT_PROPERTY_ENUM e retorna o código de status a seguir.