Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A borda de protocolo do switch extensível Hyper-V emite uma solicitação de conjunto de identificador de objeto (OID) de OID_SWITCH_PORT_PROPERTY_UPDATE para notificar extensões de switch extensíveis sobre a atualização de uma propriedade para uma política de porta de switch extensível.
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_PARAMETERS que especifica a identificação e o tipo de uma propriedade portuária.
Um buffer de propriedade que contém os parâmetros para uma política de porta. O buffer de propriedades contém uma estrutura baseada no PropertyType membro 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 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 switch extensível.
A extensão pode vetar a atualização da propriedade port retornando NDIS_STATUS_DATA_NOT_ACCEPTED para a solicitação OID. Por exemplo, se uma extensão não puder alocar recursos para aplicar suas políticas atualizadas na porta, ela deverá vetar a solicitação de atualização.
Nota Se a extensão retornar outros códigos de status de erroNDIS_STATUS_ 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 nova tentativa da notificação de criação.
Se a extensão não vetar 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 do switch extensível ou pela interface do switch 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 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 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS e os dados no buffer de propriedades da estrutura. A extensão define o DATA. SET_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário. |
NDIS_STATUS_DATA_NOT_ACCEPTED |
A extensão de encaminhamento vetou a notificação de exclusão da política portuária. |
NDIS_STATUS_NOT_SUPPORTED |
A extensão de encaminhamento não suporta a 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 de miniporta subjacente do switch extensível. A borda da miniporta retorna o seguinte código de status.
| Código de status | Descrição |
|---|---|
NDIS_STATUS_SUCCESS |
A solicitação OID foi concluída com êxito. |
Requerimentos
Versão |
Suportado no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |
Ver também
NDIS_SWITCH_PORT_PROPERTY_CUSTOM
NDIS_SWITCH_PORT_PROPERTY_PARAMETERS