DisplayState.TryFunctionalize(DisplayStateFunctionalizeOptions) Método

Definição

Namespace:

Windows.Devices.Display.Core

Tenta "funcionalizar" esse DisplayState tentando avaliar os melhores modos em todos os caminhos, considerando todas as propriedades do DisplayPath especificadas como restrições. Esse método então (opcionalmente, consulte Comentários) atualiza todas as propriedades DisplayPath e DisplayView com os resultados da funcionalização. Em particular, todas as propriedades DisplayPath e DisplayView definidas como nulas terão seus valores calculados e definidos.

public:
 virtual DisplayStateOperationResult ^ TryFunctionalize(DisplayStateFunctionalizeOptions options) = TryFunctionalize;

DisplayStateOperationResult TryFunctionalize(DisplayStateFunctionalizeOptions const& options);

public DisplayStateOperationResult TryFunctionalize(DisplayStateFunctionalizeOptions options);

function tryFunctionalize(options)

Public Function TryFunctionalize (options As DisplayStateFunctionalizeOptions) As DisplayStateOperationResult

Parâmetros

options

DisplayStateFunctionalizeOptions

O DisplayStateFunctionalizeOptions a ser usado.

Retornos

DisplayStateOperationResult

Um valor DisplayStateOperationResult detalhando o êxito ou a falha da operação.

Comentários

Use a opção ValidateTopologyOnly para impedir a atualização de todas as propriedades DisplayPath com os resultados da funcionalização.

Observe que chamar TryApply também funcionaliza implicitamente o estado antes de aplicá-lo ao sistema, mas TryApply nunca atualiza as propriedades DisplayPath desse estado com os resultados da funcionalização.

A funcionalização de um DisplayState pode ser uma operação bastante cara, pois envolve consultar drivers de exibição e comparar muitos modos possíveis. A operação geralmente será mais barata se você definir mais de suas propriedades do DisplayPath antes de chamar esse método (ou chamar TryApply), pois reduz a quantidade de trabalho necessária para avaliar o modo "melhor" em um determinado caminho.

Usar TryFunctionalize para determinar se o estado atual pode ser funcionalizado antes de chamar TryApply é uma boa prática, já que TryApply é sempre mais caro que TryFunctionalize. Depois que TryFunctionalize for bem-sucedido, uma chamada subsequente para TryApply será mais barata, já que ela não precisa mais fazer o trabalho de modos de funcionalização.