OID_SWITCH_PORT_PROPERTY_ADD

Artigo
06/15/2023

A borda de protocolo do comutador extensível do Hyper-V emite uma solicitação de conjunto OID (identificador de objeto) de OID_SWITCH_PORT_PROPERTY_ADD para notificar extensíveis extensíveis sobre a adição de uma propriedade de política para uma porta 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_PORT_PROPERTY_PARAMETERS que especifica a identificação e o tipo de parâmetros de uma política de porta.
Um buffer de propriedade que contém os parâmetros de uma política de porta. O buffer de propriedade contém uma estrutura baseada no membro PropertyType da estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . Por exemplo, se o membro PropertyType estiver definido como NdisSwitchPortPropertyTypeVlan, o buffer de propriedade conterá uma estrutura NDIS_SWITCH_PORT_PROPERTY_VLAN .

Comentários

Uma extensão de encaminhamento pode lidar com a solicitação de conjunto de OID de OID_SWITCH_PORT_PROPERTY_ADD. Todos os outros tipos de extensões devem chamar NdisFOidRequest para encaminhar a solicitação OID para a próxima extensão na pilha de driver de comutador extensível.

A extensão pode vetar a adição da propriedade de porta retornando NDIS_STATUS_DATA_NOT_ACCEPTED para a solicitação OID. Por exemplo, se uma extensão não puder alocar recursos para impor suas políticas configuradas na porta, ela deverá vetar a solicitação de adição.

Nota Se a extensão retornar outros códigos status erro NDIS_STATUS_Xxx, a notificação de criação também será vetada. No entanto, retornar status códigos para cenários transitórios, como retornar NDIS_STATUS_RESOURCES, pode resultar em uma repetição da notificação de criação.

Se a extensão não vetar a solicitação OID, ela deverá monitorar o status quando a solicitação for concluída. A extensão deve fazer isso para determinar se a solicitação OID foi vetada por extensões subjacentes no caminho de controle de comutador extensível ou pela interface do comutador extensível.

Para obter diretrizes sobre como lidar com uma solicitação de conjunto de OID de OID_SWITCH_PORT_PROPERTY_ADD, consulte Gerenciando políticas de porta.

Retornar códigos de status

Se a extensão de encaminhamento concluir a solicitação de conjunto de OID de OID_SWITCH_PORT_PROPERTY_ADD, ela retornará um dos seguintes códigos de status:

Código de status	Descrição
NDIS_STATUS_INVALID_LENGTH	O comprimento do buffer de informações é muito pequeno para processar a estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS e os dados no buffer de propriedades da estrutura. A extensão define os DADOS. SET_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.
NDIS_STATUS_DATA_NOT_ACCEPTED	A extensão de encaminhamento vetou a notificação de adição da política de porta.
NDIS_STATUS_NOT_SUPPORTED	A extensão de encaminhamento não dá suporte à política de porta.
NDIS_STATUS_Xxx	A solicitação OID falhou por outros motivos.

Se a extensão não concluir a solicitação de conjunto de OID de OID_SWITCH_PORT_PROPERTY_ADD, a solicitação será concluída pela borda do miniporto subjacente da opção extensível. A borda do miniporto retorna o seguinte código status: