다음을 통해 공유

AvSetMmMaxThreadCharacteristicsA 함수(avrt.h)

  • 아티클

호출 스레드를 지정된 태스크와 연결합니다.

통사론

AVRTAPI HANDLE AvSetMmMaxThreadCharacteristicsA(
  [in]      LPCSTR  FirstTask,
  [in]      LPCSTR  SecondTask,
  [in, out] LPDWORD TaskIndex
);

매개 변수

[in] FirstTask

수행할 첫 번째 작업의 이름입니다. 이 이름은 다음 키 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks하위 키 중 하나의 이름과 일치해야 합니다.

[in] SecondTask

수행할 두 번째 작업의 이름입니다. 이 이름은 다음 키 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks하위 키 중 하나의 이름과 일치해야 합니다.

[in, out] TaskIndex

고유한 작업 식별자입니다. 이 함수가 처음 호출될 때 이 값은 입력 시 0이어야 합니다. 인덱스 값은 출력에 반환되며 후속 호출에서 입력으로 사용할 수 있습니다.

반환 값

함수가 성공하면 태스크에 대한 핸들을 반환합니다.

함수가 실패하면 0을 반환합니다. 확장 오류 정보를 검색하려면 GetLastError호출합니다.

다음은 가능한 오류 코드입니다.

반환 코드 묘사
ERROR_INVALID_TASK_INDEX
 TaskIndex 첫 번째 호출에서 0이 아니거나(후속 호출에서) 값이 인식되지 않습니다.
ERROR_INVALID_TASK_NAME
 지정된 작업이 레지스트리에 저장된 작업과 일치하지 않습니다.
ERROR_PRIVILEGE_NOT_HELD
 호출자에게 충분한 권한이 없습니다.

발언

태스크를 수행하는 스레드의 결과 특성은 우선 순위가 가장 높은 작업을 반영합니다.

작업이 완료되면 AvRevertMmThreadCharacteristics 함수를 호출합니다.

메모

avrt.h 헤더는 AVSetMmMaxThreadCharacteristics를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 avrt.h
라이브러리 Avrt.lib
DLL Avrt.dll

참고 항목

멀티미디어 클래스 스케줄러 서비스