Método IDvdInfo2::GetDVDTextStringAsUnicode (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 GetDVDTextStringAsUnicode método recupera uma cadeia de caracteres de texto de DVD para um idioma especificado e retorna a cadeia de caracteres de texto como uma cadeia de caracteres Unicode.

Sintaxe

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 baseado em zero do idioma. Para localizar o número de idiomas de cadeia de texto no DVD, chame IDvdInfo2::GetDVDTextNumberOfLanguages.

[in] ulStringIndex

Índice baseado em zero da cadeia de caracteres a ser recuperada. Para localizar o número de cadeias de caracteres para um determinado idioma, chame IDvdInfo2::GetDVDTextLanguageInfo.

[out] pchwBuffer

Ponteiro para um buffer que recebe a cadeia de caracteres de texto. Se pchBuffer for NULL, esse método retornará o tamanho da cadeia de caracteres em pulActualSize.

[in] ulMaxBufferSize

Tamanho do buffer pchBuffer , em WCHARs.

[out] pulActualSize

Recebe o comprimento real da cadeia de caracteres em caracteres, incluindo o NULL de terminação.

[out] pType

Recebe um membro da enumeração DVD_TextStringType . O valor indica o tipo de cadeia de caracteres de texto, como o título do filme ou o nome da música. Esse parâmetro também pode receber valores que não são definidos na enumeração DVD_TextStringType .

Retornar valor

Retorna um dos seguintes valores HRESULT .

Código de retorno	Descrição
S_OK	Êxito.
E_FAIL	Te sem suporte
E_POINTER	Argumento inválido.
E_UNEXPECTED	Ocorreu um erro interno inesperado.

Comentários

Esse método dá suporte a cadeias de caracteres de texto codificadas como Unicode ou ASCII de 7 bits (ISO/IEC 646). Se a cadeia de caracteres de texto usar a codificação ASCII, o método converterá a cadeia de caracteres em uma cadeia de caracteres largos. Se a cadeia de caracteres de texto usar qualquer outro conjunto de caracteres, o método retornará E_FAIL. Nesse caso, você pode chamar IDvdInfo2::GetDVDTextStringAsNative para recuperar a cadeia de caracteres como uma matriz de bytes brutos. Para localizar o conjunto de caracteres, chame IDvdInfo2::GetDVDTextLanguageInfo.

A cadeia de caracteres retornada sempre inclui um NULL de terminação. Se o buffer for menor que o comprimento da cadeia de caracteres de texto do DVD, a cadeia de caracteres será truncada. Para localizar o tamanho necessário do buffer, chame o método uma vez com pchBuffer igual a NULL e ulMaxBufferSize igual a zero. O tamanho é retornado em pulActualSize. Em seguida, aloque um buffer e chame o método novamente.

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