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 |
---|---|
|
Correcto. |
|
Argumento no válido. |
|
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 |