Metodo IDeviceInfo2::GetDEVICETextStringAsUnicode (strmif.h)

Articolo
03/02/2024

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetDVDTextStringAsUnicode metodo recupera una stringa di testo DVD per una lingua specificata e restituisce la stringa di testo come stringa Unicode.

Sintassi

HRESULT GetDVDTextStringAsUnicode(
  [in]  ULONG              ulLangIndex,
  [in]  ULONG              ulStringIndex,
  [out] WCHAR              *pchwBuffer,
  [in]  ULONG              ulMaxBufferSize,
  [out] ULONG              *pulActualSize,
  [out] DVD_TextStringType *pType
);

Parametri

[in] ulLangIndex

Indice in base zero della lingua. Per trovare il numero di lingue di stringa di testo nel DVD, chiamare IDeviceInfo2::GetDEVICETextNumberOfLanguages.

[in] ulStringIndex

Indice in base zero della stringa da recuperare. Per trovare il numero di stringhe per una determinata lingua, chiamare IDeviceInfo2::GetTEXTLanguageInfo.

[out] pchwBuffer

Puntatore a un buffer che riceve la stringa di testo. Se pchBuffer è NULL, questo metodo restituisce le dimensioni della stringa in pulActualSize.

[in] ulMaxBufferSize

Dimensioni del buffer pchBuffer , in WCHARs.

[out] pulActualSize

Riceve la lunghezza effettiva della stringa in caratteri, inclusa la terminazione NULL.

[out] pType

Riceve un membro dell'enumerazione DVD_TextStringType . Il valore indica il tipo di stringa di testo, ad esempio il titolo del film o il nome della canzone. Questo parametro può anche ricevere valori non definiti nell'enumerazione DVD_TextStringType .

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_FAIL	Te non supportato
E_POINTER	Argomento non valido.
E_UNEXPECTED	Si è verificato un errore interno imprevisto.

Commenti

Questo metodo supporta stringhe di testo codificate come Unicode o ASCII a 7 bit (ISO/IEC 646). Se la stringa di testo usa la codifica ASCII, il metodo converte la stringa in una stringa di caratteri wide. Se la stringa di testo usa qualsiasi altro set di caratteri, il metodo restituisce E_FAIL. In questo caso, è possibile chiamare IDeviceInfo2::GetTEXTStringAsNative per recuperare la stringa come matrice di byte non elaborata. Per trovare il set di caratteri, chiamare IDeviceInfo2::GetDEVICETextLanguageInfo.

La stringa restituita include sempre un valore NULL terminante. Se il buffer è minore della lunghezza della stringa di testo DVD, la stringa viene troncata. Per trovare le dimensioni necessarie del buffer, chiamare il metodo una volta con pchBuffer uguale a NULL e ulMaxBufferSize uguale a zero. Le dimensioni vengono restituite in pulActualSize. Allocare quindi un buffer e chiamare di nuovo il metodo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Applicazioni DVD

Codici errore e esito positivo

Interfaccia IInfo2

Uso delle stringhe di testo DVD

Condividi tramite