DisplayState.TryFunctionalize(DisplayStateFunctionalizeOptions) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Tente de « fonctionnaliser » ce DisplayState en essayant d’évaluer les meilleurs modes sur tous les chemins d’accès en fonction de toutes les propriétés DisplayPath spécifiées en tant que contraintes. Cette méthode (éventuellement, voir Remarques) met à jour toutes les propriétés DisplayPath et DisplayView avec les résultats de la fonctionnalisation. En particulier, toutes les propriétés DisplayPath et DisplayView définies sur null ont leurs valeurs calculées et définies.
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 DisplayStateOperationResultParamètres
- options
- DisplayStateFunctionalizeOptions
DisplayStateFunctionalizeOptions à utiliser.
Retours
Valeur DisplayStateOperationResult détaillant la réussite ou l’échec de l’opération.
Remarques
Utilisez l’option ValidateTopologyOnly pour empêcher la mise à jour de toutes les propriétés DisplayPath avec les résultats de la fonctionnalisation.
Notez que l’appel de TryApply fonctionnalise implicitement l’état avant de l’appliquer au système, mais TryApply ne met jamais à jour les propriétés DisplayPath de cet état avec les résultats de la fonctionnalisation.
La fonctionnalité d’un DisplayState peut être une opération assez coûteuse, car elle implique l’interrogation des pilotes d’affichage et la comparaison de nombreux modes possibles. L’opération est généralement moins coûteuse si vous définissez davantage de propriétés DisplayPath avant d’appeler cette méthode (ou d’appeler TryApply), car elle réduit la quantité de travail nécessaire pour évaluer le mode « meilleur » sur un chemin donné.
L’utilisation de TryFunctionalize pour déterminer si l’état actuel peut être fonctionnel avant d’appeler TryApply est une bonne pratique, car TryApply est toujours plus cher que TryFunctionalize. Une fois que TryFunctionalize réussit, un appel ultérieur à TryApply sera moins cher, car il n’a plus à effectuer le travail de fonctionnalisation des modes.