OID_SWITCH_PROPERTY_UPDATE

Artigo
06/15/2023

A borda do protocolo do comutador extensível do Hyper-V emite uma solicitação de conjunto de OID (identificador de objeto) de OID_SWITCH_PROPERTY_UPDATE para notificar extensíveis extensíveis sobre a atualização para parâmetros para uma propriedade de política 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_PROPERTY_PARAMETERS que especifica a identificação e o tipo de uma política de comutador extensível.
Um buffer de propriedade que contém os parâmetros de uma política de comutador extensível. O buffer de propriedade contém uma estrutura baseada no membro PropertyType da estrutura NDIS_SWITCH_PROPERTY_PARAMETERS .

Nota Começando com 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 de OID de OID_SWITCH_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 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 na opção, ela deverá vetar a solicitação de atualização.

Nota 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 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 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 de comutador extensível.

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

Códigos de status de retorno

Se a extensão concluir a solicitação de conjunto OID de OID_SWITCH_PROPERTY_UPDATE, 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 atualização da política de alternância.
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_UPDATE, a solicitação será concluída pela borda de miniporto subjacente do comutador extensível. A borda do miniporta retorna o código status a seguir.