Share via

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

  • 아티클

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

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

구문

HRESULT GetDVDTextStringAsNative(
  [in]  ULONG              ulLangIndex,
  [in]  ULONG              ulStringIndex,
  [out] BYTE               *pbBuffer,
  [in]  ULONG              ulMaxBufferSize,
  [out] ULONG              *pulActualSize,
  [out] DVD_TextStringType *pType
);

매개 변수

[in] ulLangIndex

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

[in] ulStringIndex

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

[out] pbBuffer

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

[in] ulMaxBufferSize

pchBuffer의 크기(바이트)

[out] pulActualSize

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

[out] pType

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

반환 값

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

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

설명

이 메서드는 변환 없이 DVD 텍스트 문자열을 원시 바이트 배열로 반환합니다. 이 메서드를 사용하여 유니코드 이외의 문자 집합 또는 JIS Roman Kanji와 같은 7비트 ASCII(ISO/IEC 646)를 사용하여 인코딩된 텍스트 문자열을 가져올 수 있습니다. 문자 집합을 찾으려면 IDvdInfo2::GetDVDTextLanguageInfo를 호출합니다.

유니코드 및 ASCII 텍스트 문자열의 경우 와이드 문자열을 반환하는 IDvdInfo2::GetDVDTextStringAsUnicode 메서드를 사용할 수 있습니다.

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

요구 사항

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

추가 정보

DVD 응용 프로그램

오류 및 성공 코드

IDvdInfo2 인터페이스

DVD 텍스트 문자열 작업