다음을 통해 공유


EnableProcessOptionalXStateFeatures 함수(winbase.h)

이 함수는 현재 프로세스에 대해 선택적 XState 기능 집합을 사용하도록 설정합니다.

구문

BOOL EnableProcessOptionalXStateFeatures(
  DWORD64 Features
);

매개 변수

Features

각 비트가 현재 프로세스에 사용할 수 있는 선택적 XState 기능을 나타내는 비트 마스크입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

일반적으로 선택적 XState 기능은 기본적으로 새로 만든 스레드에 대해 사용하지 않도록 설정되며 나중에 요청 시 사용하도록 설정됩니다. 이 함수가 반환되면 현재 프로세스의 모든 기존 스레드에 대해 지정된 선택적 XState 기능이 사용하도록 설정되고 프로세스에서 생성된 모든 이후 스레드는 스레드 생성 시 지정된 선택적 XState 기능을 사용하도록 설정됩니다.

시스템에서 지원하는 XState 기능 비트만 이 함수에 제공할 수 있으며, 그렇지 않으면 오류가 반환됩니다. 시스템에서 지원하는 XState 기능 비트는 GetEnabledXStateFeatures 루틴을 통해 가져올 수 있습니다. 시스템에서 지원하는 선택적이 아닌 XState 기능 비트(예: AVX, AVX2 등)가 선택 사항이 아닌 XState 기능인 경우 해당 비트는 무시되며 이 함수에서 오류를 반환하지 않습니다. 시스템에서 지원하는 선택 사항이 아닌 모든 XState 기능은 기본적으로 모든 스레드에 대해 항상 사용하도록 설정됩니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 11
지원되는 최소 서버 Windows Server 2022
머리글 winbase.h

추가 정보

GetEnabledXStateFeatures

GetThreadEnabledXStateFeatures