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을 호출합니다.
ActivateObject에 대한 첫 번째 호출 후 후속 호출은 클라이언트가 ShutdownObject 또는 IMFActivate::D etachObject를 호출할 때까지 동일한 instance 대한 포인터를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | mfobjects.h |
| 라이브러리 | Mfuuid.lib |