Share via

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

  • 아티클

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

메서드는 GetDVDTextStringAsUnicode 지정된 언어에 대한 DVD 텍스트 문자열을 검색하고 텍스트 문자열을 유니코드 문자열로 반환합니다.

구문

HRESULT GetDVDTextStringAsUnicode(
  [in]  ULONG              ulLangIndex,
  [in]  ULONG              ulStringIndex,
  [out] WCHAR              *pchwBuffer,
  [in]  ULONG              ulMaxBufferSize,
  [out] ULONG              *pulActualSize,
  [out] DVD_TextStringType *pType
);

매개 변수

[in] ulLangIndex

언어의 인덱스(0부터 시작)입니다. DVD에서 텍스트 문자열 언어 수를 찾으려면 IDvdInfo2::GetDVDTextNumberOfLanguages를 호출합니다.

[in] ulStringIndex

검색할 문자열의 인덱스(0부터 시작)입니다. 지정된 언어에 대한 문자열 수를 찾으려면 IDvdInfo2::GetDVDTextLanguageInfo를 호출합니다.

[out] pchwBuffer

텍스트 문자열을 수신하는 버퍼에 대한 포인터입니다. pchBuffer가 NULL이면 이 메서드는 pulActualSize에서 문자열의 크기를 반환합니다.

[in] ulMaxBufferSize

WCHAR에서 pchBuffer 버퍼의 크기입니다.

[out] pulActualSize

종결 NULL을 포함하여 문자열의 실제 길이를 문자로 받습니다.

[out] pType

DVD_TextStringType 열거형의 멤버를 받습니다. 값은 영화 제목 또는 노래 이름과 같은 텍스트 문자열의 형식을 나타냅니다. 이 매개 변수는 DVD_TextStringType 열거형에 정의되지 않은 값을 받을 수도 있습니다.

반환 값

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

반환 코드 Description
S_OK
 성공.
E_FAIL
 지원되지 않는 te
E_POINTER
 인수가 잘못되었습니다.
E_UNEXPECTED
 예기치 않은 내부 오류가 발생했습니다.

설명

이 메서드는 유니코드 또는 7비트 ASCII(ISO/IEC 646)로 인코딩된 텍스트 문자열을 지원합니다. 텍스트 문자열에서 ASCII 인코딩을 사용하는 경우 메서드는 문자열을 와이드 문자열로 변환합니다. 텍스트 문자열이 다른 문자 집합을 사용하는 경우 메서드는 E_FAIL 반환합니다. 이 경우 IDvdInfo2::GetDVDTextStringAsNative 을 호출하여 문자열을 원시 바이트 배열로 검색할 수 있습니다. 문자 집합을 찾으려면 IDvdInfo2::GetDVDTextLanguageInfo를 호출합니다.

반환된 문자열에는 항상 종료 NULL이 포함됩니다. 버퍼가 DVD 텍스트 문자열의 길이보다 작으면 문자열이 잘립니다. 버퍼의 필요한 크기를 찾으려면 pchBuffer 가 NULL 이고 ulMaxBufferSize 가 0인 메서드를 한 번 호출합니다. 크기는 pulActualSize로 반환됩니다. 그런 다음 버퍼를 할당하고 메서드를 다시 호출합니다.

요구 사항

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

추가 정보

DVD 응용 프로그램

오류 및 성공 코드

IDvdInfo2 인터페이스

DVD 텍스트 문자열 작업