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 |
|---|---|
|
Êxito. |
|
Te sem suporte |
|
Argumento inválido. |
|
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 |