IDvdInfo2::GetAllSPRMs 메서드(strmif.h)

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

GetAllSPRMs 메서드는 모든 SPRM(시스템 매개 변수 레지스터)의 현재 콘텐츠를 검색합니다.

구문

HRESULT GetAllSPRMs(
  [out] SPRMARRAY *pRegisterArray
);

매개 변수

[out] pRegisterArray

SPRM 배열의 주소를 수신하는 SPRMARRAY 형식의 배열에 대한 포인터입니다.

반환 값

다음 HRESULT 값 중 하나를 반환합니다.

반환 코드	Description
S_OK	성공.
E_POINTER	인수가 잘못되었습니다.

설명

24개의 SPRM은 현재 언어, 하위 정보 및 기타 탐색 데이터에 대한 정보를 보유하는 데 사용됩니다.

참고 플레이어 애플리케이션은 표준 탐색 기능에 대해 이러한 읽기 전용 레지스터에 액세스할 필요가 없습니다. 이러한 레지스터를 효과적으로 사용하려면 이 설명서에 제공된 것보다 DVD 탐색 명령에 대한 자세한 지식이 필요할 수 있습니다. 다음 표에는 각 레지스터의 내용이 나열됩니다. 단어 내의 비트를 b0(낮은 순서 비트)에서 b15(상위 비트)로 지칭합니다.

 

등록	콘텐츠
0	ISO-639 언어 코드(두 개의 소문자 ASCII 문자). 기본값은 정의되지 않았습니다.
1	낮은 4비트(b0-b3)에는 오디오 스트림 번호(0~7) 또는 15(없음)가 포함됩니다. 기본값은 15입니다.
2	하위 6비트(b0-b5)에는 하위픽처 스트림 번호(0~31) 또는 62(없음) 또는 63(강제 하위 항목의 더미 스트림)이 포함됩니다. 7번째 비트(b6)에는 하위픽처 표시 플래그가 포함되어 있습니다(0 = 하위픽처를 표시하지 않음). 기본값은 62입니다.
3	낮은 4비트(b0-b3)에는 각도 번호(1~9)가 포함됩니다. 기본값은 1입니다.
4	낮은 7비트(b0-b6)에는 제목 번호(1~99)가 포함됩니다. 기본값은 1입니다.
5	낮은 7비트(b0-b6)에는 현재 VTS 내의 제목 번호(1~99)가 포함됩니다. 기본값은 1입니다.
6	낮은 15비트(b0-b14)에는 현재 타이틀의 PGC 번호(1~32767)가 포함됩니다. 기본값은 정의되지 않았습니다.
7	낮은 10비트(b0-b9)에는 챕터 번호(1~99)가 포함됩니다. 기본값은 1입니다. 타이틀이 one_sequential_PGC_title 않는 한 정의되지 않은 값입니다.
8	상위 6비트(b10-b15)에는 단추 번호(1~36)가 포함됩니다. 기본값은 1024(단추 1)입니다.
9	타이머 수(초)(0~65535)입니다. 기본값은 0입니다.
10	낮은 15비트(b0-b14)에는 현재 타이틀의 PGC 번호(1~32767)가 포함됩니다. 기본값은 정의되지 않았습니다.
11	6개의 플래그(b2: mix ch2 to ch1, b3: mix ch3 to ch1, b4: mix ch4 to ch1, b10 mix ch2 to ch0, b11: mix ch3 to ch0, b12: mix ch4 to ch0). 플래그 값이 0이면 혼합되지 않음을 의미합니다. 모든 플래그의 기본값은 0입니다. 가라오케 스트림을 재생하지 않는 경우 정의되지 않은 값입니다.
12	ISO-3166 국가/지역 코드(두 개의 대문자 ASCII 문자) 또는 65535(지정되지 않음). 기본값은 정의되지 않았습니다.
13	낮은 4비트(b0-b3)에는 부모 수준(1~8) 또는 15(없음)가 포함됩니다. 기본값은 정의되지 않았습니다.
14	b8-b9에는 현재 비디오 출력 모드가 포함되어 있습니다(0 = 일반 [4:3 또는 16:9], 1 = panscan, 2 = letterbox). b10-b11에는 기본 표시 모드가 포함되어 있습니다(0 = 4:3, 3 = 16:9). 기본값은 정의되지 않았습니다.
15	9개의 플래그(b2: SDDS 가라오케, b3: DTS 가라오케, b4: MPEG 가라오케, b6: Dolby Digital 가라오케, b7: PCM 가라오케, b10: SDDS 재생, b11: DTS 재생, b12: MPEG 재생, b14: Dolby Digital 재생). 플래그 값이 0이면 사용할 수 없음을 의미하고, 1은 가능을 의미합니다. 기본값은 정의되지 않았습니다.
16	ISO-639 언어 코드(두 개의 소문자 ASCII 문자) 또는 65535(지정되지 않음). 기본값은 65535입니다.
17	언어 확장 코드(0 = 지정되지 않음, 1 = 일반 오디오, 2 = 시각 장애인용 오디오, 3 = 디렉터 주석 #1, 4 = 디렉터 주석 #2). 기본값은 0입니다.
18	ISO-639 언어 코드(두 개의 소문자 ASCII 문자) 또는 65535(지정되지 않음). 기본값은 65535입니다.
19	언어 확장 코드(0 = 지정되지 않음, 1 = 일반 자막, 2 = 큰 자막, 3 = 자식 자막, 5 = 일반 선택 자막, 6 = 큰 선택 자막, 7 = 어린이용 선택 자막, 9 = 강제 자막, 13 = 디렉터 주석, 14 = 큰 디렉터 주석, 15 = 자식용 디렉터 주석). 기본값은 0입니다.
20	하위 8비트(b0-b7)에는 지역 코드(1~8)가 포함됩니다.

요구 사항

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

추가 정보

DVD 응용 프로그램

오류 및 성공 코드

IDvdInfo2 인터페이스