Partilhar via


OID_SWITCH_PROPERTY_ADD

A borda de protocolo do switch extensível Hyper-V emite uma solicitação de conjunto de identificador de objeto (OID) de OID_SWITCH_PROPERTY_ADD para notificar extensões de switch extensíveis sobre a adição de uma propriedade de política de switch

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_PROPERTY_PARAMETERS que especifica a identificação e o tipo de uma política de switch extensível.

  • Um buffer de propriedades que contém os parâmetros para uma política de switch extensível. O buffer de propriedades contém uma estrutura baseada no PropertyType membro da estrutura NDIS_SWITCH_PROPERTY_PARAMETERS.

    Observação A partir do Windows Server 2012, o membro PropertyType deve ser definido como NdisSwitchPropertyTypeCustom e o buffer de propriedade deve conter uma estrutura NDIS_SWITCH_PROPERTY_CUSTOM.

Comentários

Uma extensão de encaminhamento pode lidar com a solicitação de conjunto OID de OID_SWITCH_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 switch extensível.

A extensão pode vetar a adição da propriedade switch 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 atualizadas no switch, ela deverá vetar a solicitação de adição.

Observação Se a extensão retornar outros códigos de status de erro NDIS_STATUS_Xxx, a notificação de criaçã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_PROPERTY_ADD, consulte Gerenciando políticas de switch.

Códigos de status de retorno

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

Código de status Descrição

NDIS_STATUS_DATA_NOT_ACCEPTED

A extensão vetou a notificação de adição da política de switch.

NDIS_STATUS_FAILURE

A solicitação OID falhou por outros motivos.

Se a extensão não concluir a solicitação de conjunto OID de OID_SWITCH_PROPERTY_ADD, 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_OID_REQUEST

NDIS_SWITCH_PROPERTY_CUSTOM

NDIS_SWITCH_PROPERTY_PARAMETERS

NdisFOidRequest