Método IDvdInfo2::GetDVDTextStringAsNative (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetDVDTextStringAsNative método recupera una cadena de texto de DVD para un idioma especificado y devuelve la cadena de texto como una matriz de bytes.

Sintaxis

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

Parámetros

[in] ulLangIndex

Índice de base cero del lenguaje. Para buscar el número de idiomas de cadena de texto en el DVD, llame a IDvdInfo2::GetDVDTextNumberOfLanguages.

[in] ulStringIndex

Índice de base cero de la cadena que se va a recuperar. Para buscar el número de cadenas de un idioma determinado, llame a IDvdInfo2::GetDVDTextLanguageInfo.

[out] pbBuffer

Puntero a un búfer que recibe la cadena de texto. Si pchBuffer es NULL, este método devuelve el tamaño de la cadena en pulActualSize.

[in] ulMaxBufferSize

Tamaño de pchBuffer en bytes

[out] pulActualSize

Recibe la longitud real de la cadena en bytes, incluido el valor NULL de terminación.

[out] pType

Recibe un miembro de la enumeración DVD_TextStringType . El valor indica el tipo de cadena de texto, como el título de la película o el nombre de la canción. Este parámetro también puede recibir valores que no están definidos en la enumeración DVD_TextStringType .

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	Argumento no válido.
E_UNEXPECTED	Error interno inesperado.

Comentarios

Este método devuelve una cadena de texto de DVD como una matriz de bytes sin formato, sin conversiones. Puede usar este método para obtener cadenas de texto codificadas mediante juegos de caracteres distintos de Unicode o ASCII de 7 bits (ISO/IEC 646), como JIS Roman Kanji. Para buscar el juego de caracteres, llame a IDvdInfo2::GetDVDTextLanguageInfo.

Para las cadenas de texto Unicode y ASCII, puede usar el método IDvdInfo2::GetDVDTextStringAsUnicode , que devuelve una cadena de caracteres anchos.

La cadena devuelta siempre incluye un solo byte NULL de terminación. Si el búfer es menor que la longitud de la cadena de texto de DVD, la cadena se trunca. Para buscar el tamaño necesario del búfer, llame al método una vez con pchBuffer igual a NULL y ulMaxBufferSize igual a cero. El tamaño se devuelve en pulActualSize. A continuación, asigne un búfer y vuelva a llamar al método .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdInfo2 (Interfaz)

Trabajar con cadenas de texto de DVD