SetUmsThreadInformation 함수(winbase.h)
지정된 UMS(사용자 모드 예약) 작업자 스레드에 대한 애플리케이션별 컨텍스트 정보를 설정합니다.
경고
Windows 11 현재 사용자 모드 일정은 지원되지 않습니다. 오류로 모든 호출이 실패합니다 ERROR_NOT_SUPPORTED
.
구문
BOOL SetUmsThreadInformation(
[in] PUMS_CONTEXT UmsThread,
[in] UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
[in] PVOID UmsThreadInformation,
[in] ULONG UmsThreadInformationLength
);
매개 변수
[in] UmsThread
UMS 스레드 컨텍스트에 대한 포인터입니다.
[in] UmsThreadInfoClass
설정할 정보의 종류를 지정하는 UMS_THREAD_INFO_CLASS 값입니다. 이 매개 변수는 UmsThreadUserContext여야 합니다.
[in] UmsThreadInformation
설정할 정보가 포함된 버퍼에 대한 포인터입니다.
[in] UmsThreadInformationLength
UmsThreadInformation 버퍼의 크기(바이트)입니다.
반환 값
함수가 성공하면 0이 아닌 값을 반환합니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 가능한 오류 값은 다음과 같습니다.
반환 코드 | 설명 |
---|---|
|
버퍼 크기가 지정된 정보 클래스에 필요한 크기와 일치하지 않습니다. |
|
UmsThreadInfoClass 매개 변수는 지원되지 않는 정보 클래스를 지정합니다. |
|
UMS는 지원되지 않습니다. |
설명
SetUmsThreadInformation 함수를 사용하여 지정된 UMS 작업자 스레드에 대한 애플리케이션 정의 컨텍스트를 설정할 수 있습니다. 컨텍스트 정보는 스케줄러별 또는 작업자별 스레드 상태와 같이 애플리케이션이 추적하는 데 유용할 수 있는 모든 항목으로 구성될 수 있습니다. UMS 작업자 스레드의 기본 구조는 시스템에서 관리되며 직접 수정해서는 안 됩니다.
QueryUmsThreadInformation 함수를 사용하여 지정된 스레드에 대해 노출된 다른 정보(예: TEB(스레드 실행 블록) 및 스레드가 일시 중단 또는 종료되었는지 여부를 검색할 수 있습니다. QueryUmsThreadInformation을 통해 노출되지 않는 정보는 예약된 것으로 간주되어야 합니다.
요구 사항
지원되는 최소 클라이언트 | Windows 7(64비트 전용) [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | winbase.h(Windows.h 포함) |
라이브러리 | Kernel32.lib |
DLL | Kernel32.dll |
API 세트 | api-ms-win-core-ums-l1-1-0(Windows 7에 도입됨) |