Método IDvdInfo2::GetDVDTextStringAsNative (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 GetDVDTextStringAsNative 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 matriz de bytes.

Sintaxe

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 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] pbBuffer

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 pchBuffer em bytes

[out] pulActualSize

Recebe o comprimento real da cadeia de caracteres em bytes, incluindo o nulo 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_POINTER	Argumento inválido.
E_UNEXPECTED	Ocorreu um erro interno inesperado.

Comentários

Esse método retorna uma cadeia de caracteres de texto de DVD como uma matriz de bytes brutos, sem conversões. Você pode usar esse método para obter cadeias de caracteres de texto codificadas usando conjuntos de caracteres diferentes de Unicode ou ASCII de 7 bits (ISO/IEC 646), como JIS Roman Kanji. Para localizar o conjunto de caracteres, chame IDvdInfo2::GetDVDTextLanguageInfo.

Para cadeias de caracteres de texto Unicode e ASCII, você pode usar o método IDvdInfo2::GetDVDTextStringAsUnicode , que retorna uma cadeia de caracteres largos.

A cadeia de caracteres retornada sempre inclui um único byte 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