Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A borda do protocolo do comutador extensível Hyper-V emite uma solicitação de conjunto OID (identificador de objeto) de OID_SWITCH_PORT_PROPERTY_UPDATE para notificar extensíveis extensíveis sobre a atualização de uma propriedade para uma política de porta de comutador extensível.
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_PARAMETERS que especifica a identificação e o tipo de uma propriedade 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 PropertyType membro da estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS. Por exemplo, se o membro PropertyType for definido como NdisSwitchPortPropertyTypeVlan, o buffer de propriedade conterá uma estrutura NDIS_SWITCH_PORT_PROPERTY_VLAN.
Observações
Uma extensão de encaminhamento pode lidar com a solicitação de conjunto OID de OID_SWITCH_PORT_PROPERTY_UPDATE. 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 atualização da propriedade de porta retornando NDIS_STATUS_DATA_NOT_ACCEPTED para a solicitação de OID. Por exemplo, se uma extensão não puder alocar recursos para impor suas políticas atualizadas na porta, ela deverá vetar a solicitação de atualização.
Observação Se a extensão retornar outras NDIS_STATUS_códigos de status de erro xxx, a notificação de atualização também será vetada. No entanto, retornar códigos de status 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 veta a solicitação OID, ela deve 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 de comutador extensível.
Para obter diretrizes sobre como lidar com uma solicitação de conjunto de OID de OID_SWITCH_PORT_PROPERTY_UPDATE, consulte Gerenciando políticas de porta.
Códigos de status de retorno
Se a extensão de encaminhamento concluir a solicitação de conjunto de OID de OID_SWITCH_PORT_PROPERTY_UPDATE, 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 de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS e os dados no buffer de propriedade da estrutura. A extensão define o DATA. SET_INFORMATION. BytesNeededed membro 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 exclusã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 OID de OID_SWITCH_PORT_PROPERTY_UPDATE, a solicitação será concluída pela borda do miniporto subjacente da opção extensível. A borda do miniporto retorna o código de status a seguir.
| Código de status | Descrição |
|---|---|
NDIS_STATUS_SUCCESS |
A solicitação OID foi concluída com êxito. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |
Consulte também
NDIS_SWITCH_PORT_PROPERTY_CUSTOM
NDIS_SWITCH_PORT_PROPERTY_PARAMETERS