IMFActivate::ActivateObject 메서드(mfobjects.h)

이 활성화 개체와 연결된 개체를 만듭니다.

구문

HRESULT ActivateObject(
  [in]  REFIID riid,
  [out] void   **ppv
);

매개 변수

[in] riid

요청된 인터페이스의 IID(인터페이스 식별자)입니다.

[out] ppv

요청된 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

일부 Microsoft Media Foundation 개체는 해제되기 전에 종료해야 합니다. 이 경우 호출자는 ppv로 반환되는 개체를 종료해야 합니다. 개체를 종료하려면 다음 중 하나를 수행합니다.

• 활성화 개체에서 IMFActivate::ShutdownObject 를 호출하거나
• 개체별 종료 메서드를 호출합니다. 이 메서드는 개체의 형식에 따라 달라집니다. 가능한 항목은 다음과 같습니다.
  • 미디어 원본: IMFMediaSource::Shutdown을 호출합니다.
  • 미디어 싱크: IMFMediaSink::Shutdown을 호출합니다.
  • IMFShutdown 인터페이스를 지원하는 모든 개체: IMFShutdown::Shutdown을 호출합니다.

IMFActivate::ShutdownObject 메서드는 모든 개체 형식에 대해 제네릭입니다. 개체에 종료 메서드가 필요하지 않으면 ShutdownObject 가 성공하고 아무런 효과가 없습니다. 개체에 대한 특정 종료 방법을 모르거나 개체 형식을 모르는 경우 IMFActivate::ShutdownObject를 호출합니다.

ActivateObject에 대한 첫 번째 호출 후 후속 호출은 클라이언트가 ShutdownObject 또는 IMFActivate::D etachObject를 호출할 때까지 동일한 instance 대한 포인터를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	mfobjects.h
라이브러리	Mfuuid.lib

추가 정보

활성화 개체

IMFActivate