ICodecAPI::RegisterForEvent 메서드(strmif.h)

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

RegisterForEvent 메서드는 코덱에서 이벤트를 수신하도록 애플리케이션을 등록합니다.

구문

HRESULT RegisterForEvent(
  [in]  const GUID *Api,
  [out] LONG_PTR   userData
);

매개 변수

[in] Api

이벤트를 지정하는 GUID에 대한 포인터입니다. 세 가지 범주의 이벤트가 있습니다.

값	의미
CODECAPI_CHANGELISTS	코덱은 코덱의 속성이 변경되면 애플리케이션에 알 수 있습니다. 이벤트 데이터는 변경된 속성에 대한 GUID 목록입니다.
codecapi.h에 정의된 속성 GUID 중 하나입니다. ( 코덱 API 속성을 참조하세요.)	코덱은 지정된 속성이 변경될 때 애플리케이션에 알 수 있습니다. 일반적으로 코덱은 제한된 속성 집합(있는 경우)에 대해 이러한 유형의 알림을 지원합니다.
코덱에서 정의한 독점 이벤트 GUID입니다.	구현 종속적입니다.

[out] userData

호출자 정의 데이터에 대한 포인터입니다. 애플리케이션은 lParam1 이벤트 매개 변수에서 이 포인터를 받습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_NOTIMPL	구현되지 않았습니다. 코덱은 이벤트 알림을 지원하지 않거나 Api 매개 변수에 지정된 이벤트 GUID를 지원하지 않습니다.

설명

애플리케이션은 인코더 코덱이 이벤트를 보낼 때마다 EC_CODECAPI_EVENT 이벤트 알림을 받습니다. 이벤트를 얻으려면 IMediaEventEx 인터페이스를 사용합니다.

이벤트의 lParam2 매개 변수는 CodecAPIEventData 구조체에 대한 포인터입니다. 이 구조는 이벤트 GUID에 따라 추가 데이터를 따를 수 있습니다. 이 데이터의 크기는 dataLength 멤버가 지정합니다.

GUID	이벤트 데이터
CODECAPI_CHANGELISTS	GUID 배열입니다. 각 GUID는 현재 값 또는 유효한 범위가 변경된 코덱 속성을 지정합니다. 배열의 크기는 dataLength / sizeof(GUID)입니다.
codecapi.h에 정의된 속성 GUID입니다.	없음
독점 이벤트 GUID입니다.	구현 종속적입니다.

 

코덱이 지정된 이벤트를 지원하지 않으면 메서드는 E_NOTIMPL 반환합니다. 코덱은 다른 이벤트를 지원할 수 있습니다.

이벤트에 대한 알림을 사용하지 않도록 설정하려면 ICodecAPI::UnregisterForEvent를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	strmif.h(Dshow.h 포함)
라이브러리	Strmiids.lib

추가 정보

코덱 API 참조

인코더 API

ICodecAPI