FltApplyPriorityInfoThread 함수(fltkernel.h)

아티클
08/07/2023

FltApplyPriorityInfoThread 루틴은 미니필터 드라이버에서 스레드에 우선 순위 정보를 적용하는 데 사용됩니다.

구문

NTSTATUS FLTAPI FltApplyPriorityInfoThread(
  [in]            PIO_PRIORITY_INFO InputPriorityInfo,
  [out, optional] PIO_PRIORITY_INFO OutputPriorityInfo,
  [in]            PETHREAD          Thread
);

매개 변수

[in] InputPriorityInfo

지정된 스레드의 우선 순위 상태를 설정하는 데 사용되는 IO_PRIORITY_INFO 구조체에 대한 포인터입니다. 이 IO_PRIORITY_INFO 구조체에는 해당 멤버가 적절한 루틴으로 설정되어 있어야 합니다. 다음 설명 섹션을 참조하세요. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[out, optional] OutputPriorityInfo

InputPriorityInfo 우선 순위 정보가 FltApplyPriorityInfoThread에 의해 스레드에 적용되기 전에 스레드의 우선 순위 상태를 수신하는 데 사용되는 IO_PRIORITY_INFO 구조체에 대한 선택적 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[in] Thread

InputPriorityInfo 우선 순위 정보를 적용할 스레드에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

반환 값

InputPriorityInfo 매개 변수가 가리키는 스레드 우선 순위 정보가 지정된 스레드에 성공적으로 적용되면 FltApplyPriorityInfoThread 루틴은 STATUS_SUCCESS 반환합니다. 그렇지 않으면 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.

반환 코드	설명
STATUS_INVALID_PARAMETER_1	InputPriorityInfo 매개 변수가 가리키는 구조체가 초기화되었지만 하나 이상의 멤버 값이 잘못되었습니다. 오류 코드입니다.

설명

이 루틴은 Windows Vista부터 사용할 수 있습니다.

FltApplyPriorityInfoThread 루틴은 InputPriorityInfo 매개 변수가 가리키는 IO_PRIORITY_INFO 구조체의 멤버 값을 기반으로 지정된 스레드의 I/O 우선 순위, 페이징 우선 순위 및 스레드 우선 순위를 설정합니다. 이렇게 하면 FltRetrieveIoPriorityInfo 또는 FltApplyPriorityInfoThread 루틴에서 가져온 이전에 저장된 우선 순위 정보 집합을 스레드에 적용할 수 있습니다.

FltApplyPriorityInfoThread 루틴에서 InputPriorityInfo 우선 순위 값을 적용하기 전에 대상 스레드의 원래 값은 유효한 OutputPriorityInfo 포인터가 제공된 경우 저장할 수 있습니다. OutputPriorityInfo 매개 변수가 가리키는 구조체를 초기화할 필요가 없습니다.

InputPriorityInfo 및 OutputPriorityInfo 매개 변수 모두에 대해 단일 IO_PRIORITY_INFO 구조체에 동일한 포인터를 제공하는 것이 안전합니다.

참고InputPriorityInfo 매개 변수가 가리키는 IO_PRIORITY_INFO 구조체의 멤버 값이 설정되지 않은 경우 다음 방법 중 하나를 사용하여 FltApplyPriorityInfoThread 루틴을 호출하기 전에 이러한 멤버를 설정해야 합니다.

FltRetrieveIoPriorityInfo 루틴을 호출합니다.
FltApplyPriorityInfoThread 루틴에 대한 이전 호출에서 현재 InputPriorityInfo 매개 변수가 OutputPriorityInfo 매개 변수인지 확인합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	fltkernel.h(Fltkernel.h 포함)
라이브러리	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL