IMFAsyncCallback::GetParameters 메서드(mfobjects.h)

  • 아티클

콜백을 위해 디스패치 스레드에 구성 정보를 제공합니다.

구문

HRESULT GetParameters(
  [out] DWORD *pdwFlags,
  [out] DWORD *pdwQueue
);

매개 변수

[out] pdwFlags

콜백 개체의 IMFAsyncCallback::Invoke 메서드의 동작을 나타내는 플래그를 받습니다. 다음 값이 정의됩니다. 기본값은 영입니다.

값 의미
Zero
 콜백을 완료하는 데 시간이 오래 걸리지 않지만 시스템 호출에 대한 구체적인 제한은 없습니다. 콜백을 완료하는 데 일반적으로 30밀리초 미만이 걸립니다.
MFASYNC_FAST_IO_PROCESSING_CALLBACK
 콜백은 매우 최소한의 처리를 수행합니다. 완료하는 데 1밀리초 미만이 걸립니다.

콜백은 다음 작업 큐 중 하나에서 호출되어야 합니다.

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_SIGNAL_CALLBACK
 콜백이 처리하지 않는다는 추가 제한(50마이크로초 미만)을 포함하는 MFASYNC_FAST_IO_PROCESSING_CALLBACK 의미하며 , SetEvent만 시스템 호출을 수행합니다.

콜백은 다음 작업 큐 중 하나에서 호출되어야 합니다.

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_BLOCKING_CALLBACK
 콜백 차단.
MFASYNC_REPLY_CALLBACK
 회신 콜백.

[out] pdwQueue

콜백이 디스패치되는 작업 큐의 식별자를 받습니다.

이 값은 표준 Media Foundation 작업 큐 중 하나 또는 애플리케이션에서 만든 작업 큐를 지정할 수 있습니다. 표준 Media Foundation 작업 큐 목록은 작업 큐 식별자를 참조하세요. 새 작업 큐를 만들려면 MFAllocateWorkQueue를 호출합니다. 기본값은 MFASYNC_CALLBACK_QUEUE_STANDARD.

작업 큐가 pdwFlags에서 반환된 값과 호환되지 않는 경우 Media Foundation 플랫폼은 콜백을 디스패치하려고 할 때 MF_E_INVALID_WORKQUEUE 반환합니다. ( MFPutWorkItem을 참조하세요.)

반환 값

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

반환 코드 설명
S_OK
 메서드가 성공했습니다.
E_NOTIMPL
 구현되지 않았습니다. 기본 동작을 가정합니다.

설명

GetParameters 메서드는 디스패치 스레드가 콜백을 호출하는 데 사용하는 프로세스를 최적화할 수 있도록 콜백에 대한 정보를 반환합니다.

메서드가 pdwFlags 매개 변수에서 0이 아닌 값을 반환하는 경우 Invoke 메서드는 여기에 설명된 요구 사항을 충족해야 합니다. 그렇지 않으면 콜백으로 파이프라인이 지연될 수 있습니다.

두 매개 변수 모두에 대한 기본값을 원하는 경우 E_NOTIMPL 반환합니다. 기본값은 이 페이지의 매개 변수 설명에 제공됩니다.

이 인터페이스는 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 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 mfobjects.h(Mfidl.h 포함)
라이브러리 Mfuuid.lib

추가 정보

비동기 콜백 메서드

IMFAsyncCallback

작업 큐