MFBeginRegisterWorkQueueWithMMCSSEx 함수(mfapi.h)

작업 큐를 MMCSS(멀티미디어 클래스 스케줄러 서비스) 작업에 연결합니다.

구문

HRESULT MFBeginRegisterWorkQueueWithMMCSSEx(
  [in] DWORD            dwWorkQueueId,
  [in] LPCWSTR          wszClass,
  [in] DWORD            dwTaskId,
  [in] LONG             lPriority,
  [in] IMFAsyncCallback *pDoneCallback,
  [in] IUnknown         *pDoneState
);

매개 변수

[in] dwWorkQueueId

작업 큐의 식별자입니다. 프라이빗 작업 큐의 경우 MFAllocateWorkQueue 함수에서 식별자가 반환됩니다. 플랫폼 작업 큐는 작업 큐 식별자를 참조하세요.

[in] wszClass

MMCSS 작업의 이름입니다. 자세한 내용은 멀티미디어 클래스 스케줄러 서비스를 참조하세요.

[in] dwTaskId

고유한 작업 식별자입니다. 새 작업 식별자를 가져오려면 이 값을 0으로 설정합니다.

[in] lPriority

작업 큐 스레드의 기본 상대 우선 순위입니다. 자세한 내용은 AvSetMmThreadPriority를 참조하세요.

[in] pDoneCallback

콜백 개체의 IMFAsyncCallback 인터페이스에 대한 포인터입니다. 호출자는 이 인터페이스를 구현해야 합니다.

[in] pDoneState

호출자가 정의한 상태 개체의 IUnknown 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 이 개체를 사용하여 상태 정보를 저장할 수 있습니다. 콜백이 호출될 때 개체가 호출자에게 반환됩니다.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수는 lPriority 매개 변수를 추가하여 MFBeginRegisterWorkQueueWithMMCSS 함수를 확장합니다.

이 함수는 비동기입니다. 작업이 완료되면 콜백 개체의 IMFAsyncCallback::Invoke 메서드가 호출됩니다. 이때 MFEndRegisterWorkQueueWithMMCSS 를 호출하여 비동기 요청을 완료합니다.

MMCSS 작업에서 작업 큐의 등록을 취소하려면 MFBeginUnregisterWorkQueueWithMMCSS를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mfapi.h
DLL	Mfplat.dll

추가 정보

미디어 파운데이션 함수

작업 큐 및 스레딩 개선 사항

작업 큐