Método IDvdInfo2::GetDVDTextStringAsUnicode (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 GetDVDTextStringAsUnicode método recupera una cadena de texto de DVD para un idioma especificado y devuelve la cadena de texto como una cadena Unicode.

Sintaxis

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

Parámetros

[in] ulLangIndex

Índice de base cero del idioma. 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] pchwBuffer

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 del búfer pchBuffer , en WCHAR.

[out] pulActualSize

Recibe la longitud real de la cadena en caracteres, 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_FAIL	Te no compatible
E_POINTER	Argumento no válido.
E_UNEXPECTED	Error interno inesperado.

Comentarios

Este método admite cadenas de texto codificadas como Unicode o ASCII de 7 bits (ISO/IEC 646). Si la cadena de texto usa codificación ASCII, el método convierte la cadena en una cadena de caracteres anchos. Si la cadena de texto usa cualquier otro juego de caracteres, el método devuelve E_FAIL. En ese caso, puede llamar a IDvdInfo2::GetDVDTextStringAsNative para recuperar la cadena como una matriz de bytes sin formato. Para buscar el juego de caracteres, llame a IDvdInfo2::GetDVDTextLanguageInfo.

La cadena devuelta siempre incluye un valor 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 (incluya 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