DisplayState.TryFunctionalize(DisplayStateFunctionalizeOptions) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 모든 DisplayPath 속성을 제약 조건으로 지정된 모든 경로에서 최상의 모드를 평가하려고 시도하여 이 DisplayState 를 "기능화"하려고 시도합니다. 그런 다음(선택적으로 설명 참조) 이 함수화의 결과로 모든 DisplayPath 및 DisplayView 속성을 업데이트합니다. 특히 null로 설정된 모든 DisplayPath 및 DisplayView 속성에는 해당 값이 계산되고 설정됩니다.
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를 기능화하는 작업은 디스플레이 드라이버를 쿼리하고 가능한 많은 모드를 비교하는 작업이 포함되므로 상당히 비용이 많이 들 수 있습니다. 이 메서드를 호출하거나 TryApply를 호출하기 전에 DisplayPath 속성을 더 많이 설정하면 지정된 경로에서 "최적" 모드를 평가하는 데 필요한 작업량이 줄어들기 때문에 일반적으로 작업이 더 저렴합니다.
TryApply는 항상 TryFunctionalize보다 비용이 많이 들기 때문에 TryFunctionalize를 사용하여 TryApply를 호출 하기 전에 현재 상태를 기능화할 수 있는지 여부를 확인하는 것이 좋습니다. TryFunctionalize가 성공하면 TryApply에 대한 후속 호출은 더 이상 기능화 모드 작업을 수행할 필요가 없으므로 더 저렴합니다.