OID_SWITCH_PORT_PROPERTY_ENUM

Artigo
03/13/2025

A extensão de switch extensível Hyper-V emite uma solicitação de método de identificador de objeto (OID) 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 switch extensível especificada.

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

Observação Se o NumProperties membro da estrutura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS estiver 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 switch extensível deve seguir estas diretrizes:

A extensão só pode emitir a solicitação de OID_SWITCH_PORT_PROPERTY_ENUM depois que a borda de protocolo do switch extensível emite 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 deve 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 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.

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 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_PORT_PROPERTY_ENUM e retorna o seguinte código de status.