MFScheduleWorkItem 함수(mfapi.h)

지정된 간격 후에 완료될 비동기 작업을 예약합니다.

구문

HRESULT MFScheduleWorkItem(
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *pState,
  [in]  INT64            Timeout,
  [out] MFWORKITEM_KEY   *pKey
);

매개 변수

[in] pCallback

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

[in] pState

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

[in] Timeout

시간 제한 간격(밀리초)입니다. 이 매개 변수를 음수 값으로 설정합니다. 콜백은 시간 제한 (밀리초) 후에 호출됩니다. 예를 들어 시간 제한이 -5000인 경우 콜백은 5000밀리초 후에 호출됩니다.

[out] pKey

타이머를 취소하는 데 사용할 수 있는 키를 받습니다. 타이머를 취소하려면 MFCancelWorkItem을 호출하고 Key 매개 변수에 이 키를 전달합니다.

반환 값

함수는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	함수가 성공했습니다.

설명

이 함수는 비동기 결과 개체를 만듭니다. 타이머 간격이 경과하면 pCallback으로 지정된 IMFAsyncCallback::Invoke 메서드가 호출됩니다.

이 함수는 Windows Media Format 11 SDK 재배포 가능 구성 요소가 설치된 경우 다음 플랫폼에서 사용할 수 있습니다.

• Windows XP SP2(서비스 팩 2) 이상
• KB900325(Windows XP Media Center Edition 2005) 및 KB925766(Windows XP Media Center Edition용 2006년 10월 업데이트 롤업)가 설치된 Windows XP Media Center Edition 2005.

요구 사항

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

추가 정보

MFScheduleWorkItemEx

미디어 파운데이션 함수

작업 큐