DirectShow DirectShow 레퍼런스 인터페이스 IDvdControl2 SetSubpictureState   [목차열람] [주소복사] [슬롯비우기]
IDvdControl2::SetSubpictureState
 
Microsoft DirectX 9.0

IDvdControl2::SetSubpictureState

SetSubpictureState 메서드는, 서브 픽쳐의 표시의 온/오프를 바꾼다.

구문

HRESULT SetSubpictureState(
  BOOL bState,
  DWORD dwFlags,
  IDvdCmd **ppCmd
);

파라미터

bState

[in] 서브 픽쳐의 표시를 온으로 할지 어떨지를 지정하는 불형의 값. TRUE 를 지정 하면, 그 이후의 재생으로 서브 픽쳐가 표시된다.

dwFlags

[in] 커멘드 동기 옵션을 지정하는 1 개 이상의 DVD_CMD_FLAGS 열거를 포함한 비트 플래그.

ppCmd

[out] DVD 커멘드의 동기가 사용할 수 있는 IDvdCmd 개체의 포인터 주소.

반환값

다음의 몇개의 값을 돌려준다.

반환 코드 설명
S_OK 성공.
VFW_E_DVD_INVALIDDOMAIN DVD 네비게이터가 First Play 도메인내에 있다.
VFW_E_DVD_OPERATION_INHIBITED UOP 컨트롤이 처리를 금지하고 있다.

주의

보통, 서브 픽쳐 스트림은, 메뉴에서는 버튼 텍스트나 경우에 따라서는 버튼의 그래픽에, 비디오의 재생에서는 자막, 크레디트, 그 외의 오버레이 그래픽에 사용된다. 서브 픽쳐를 자막 방송과 혼동 해서는 안 된다. 자막 방송은, 비디오 스트림의 내부에 encode 되고 있다. 일반적으로, 이 메서드는, DVD 네비게이터 필터가 DVD 타이틀 도메인내에서 비디오를 재생하고 있는 동안에 비디오에 거듭해 표시되는 서브 픽쳐를 제어하는 것을 목적으로 하고 있다.

이 메서드는, Annex J "Sub-picture_Stream_Change" 커멘드의 제 2 인수에 상당한다.

다음의 표는, 이 메서드명이 대응하는 Annex J 커멘드명, 이 메서드가 유효한 도메인을 나타내고 있다.

Annex J 커멘드명 유효한 도메인
Sub-picture_stream_Change DVD_DOMAIN_VideoManagerMenu
DVD_DOMAIN_VideoTitleSetMenu
DVD_DOMAIN_Title
DVD_DOMAIN_Stop

참조

↑TOP