Compartilhar via


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

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O GetDVDTextLanguageInfo método recupera informações sobre as cadeias de caracteres de texto para um idioma especificado. O método recupera o número de cadeias de caracteres para esse idioma, o identificador de localidade e o conjunto de caracteres.

Sintaxe

HRESULT GetDVDTextLanguageInfo(
  [in]  ULONG           ulLangIndex,
  [out] ULONG           *pulNumOfStrings,
  [out] LCID            *pLangCode,
  [out] DVD_TextCharSet *pbCharacterSet
);

Parâmetros

[in] ulLangIndex

Índice baseado em zero da linguagem a ser consultada. Para localizar o número de idiomas de cadeia de texto no DVD, chame IDvdInfo2::GetDVDTextNumberOfLanguages.

[out] pulNumOfStrings

Recebe o número de cadeias de caracteres de texto para o idioma especificado.

[out] pLangCode

Recebe um LCID ( identificador de localidade ) que especifica o idioma no qual o texto é escrito. Por exemplo, o LCID para "en-us" é 0x0409.

[out] pbCharacterSet

Recebe um membro da enumeração DVD_TextCharSet . O valor especifica o conjunto de caracteres da cadeia de caracteres de texto.

Retornar valor

Retorna um dos seguintes valores HRESULT .

Código de retorno Descrição
S_OK
Êxito.
E_INVALIDARG
Este DVD não tem nenhuma cadeia de caracteres de texto ou o parâmetro ulLangIndex está fora dos limites.
E_POINTER
Argumento de ponteiro NULL.
E_UNEXPECTED
Ocorreu um erro interno inesperado.

Comentários

Para obter uma cadeia de caracteres de texto específica, chame IDvdInfo2::GetDVDTextStringAsUnicode ou IDvdInfo2::GetDVDTextStringAsNative.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Aplicativos de DVD

Códigos de erro e êxito

IDvdInfo2 Interface

Trabalhando com cadeias de caracteres de texto de DVD