DisplayState.TryFunctionalize(DisplayStateFunctionalizeOptions) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Пытается "функционализировать" этот DisplayState , пытаясь оценить лучшие режимы для всех путей, учитывая все указанные свойства DisplayPath в качестве ограничений. Затем этот метод (необязательно, см. раздел Примечания) обновляет все свойства DisplayPath и DisplayView с результатами функционализации. В частности, все свойства DisplayPath и DisplayView , для которых задано значение NULL, будут вычисляться и устанавливаться.
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Параметры
- options
- DisplayStateFunctionalizeOptions
Используемый объект DisplayStateFunctionalizeOptions .
Возвращаемое значение
Значение DisplayStateOperationResult с подробными сведениями об успешном или неудачном выполнении операции.
Комментарии
Используйте параметр ValidateTopologyOnly, чтобы предотвратить обновление всех свойств DisplayPath с результатами функционализации.
Обратите внимание, что вызов TryApply также неявно функционализирует состояние перед его применением к системе, но TryApply никогда не обновляет свойства DisplayPath этого состояния с результатами функционализации.
Функционализация DisplayState может быть довольно дорогостоящей операцией, так как она включает запросы к драйверам дисплея и сравнение многих возможных режимов. Операция обычно будет дешевле, если задать больше свойств DisplayPath перед вызовом этого метода (или вызова TryApply), так как она сокращает объем работы, необходимой для оценки "лучшего" режима по заданному пути.
Рекомендуется использовать TryFunctionalize для определения возможности функционирования текущего состояния перед вызовом TryApply , так как tryApply всегда дороже , чем TryFunctionalize. После успешного выполнения TryFunctionalize последующий вызов TryApply будет дешевле, так как ему больше не нужно выполнять работу по функционализации режимов.