Metodo IDeviceInfo2::GetDEVICETextStringAsNative (strmif.h)
[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 GetDVDTextStringAsNative
metodo recupera una stringa di testo DVD per una lingua specificata e restituisce la stringa di testo come matrice di byte.
Sintassi
HRESULT GetDVDTextStringAsNative(
[in] ULONG ulLangIndex,
[in] ULONG ulStringIndex,
[out] BYTE *pbBuffer,
[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] pbBuffer
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 pchBuffer in byte
[out] pulActualSize
Riceve la lunghezza effettiva della stringa in byte, 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 |
---|---|
|
Operazione completata. |
|
Argomento non valido. |
|
Si è verificato un errore interno imprevisto. |
Commenti
Questo metodo restituisce una stringa di testo DVD come matrice di byte non elaborata, senza conversioni. È possibile usare questo metodo per ottenere stringhe di testo codificate usando set di caratteri diversi da Unicode o 7 bit ASCII (ISO/IEC 646), ad esempio JIS Roman Kanji. Per trovare il set di caratteri, chiamare IDeviceInfo2::GetDEVICETextLanguageInfo.
Per le stringhe di testo Unicode e ASCII, è possibile usare il metodo IDeviceInfo2::GetASCIITextStringAsUnicode , che restituisce una stringa di caratteri wide.
La stringa restituita include sempre un singolo byte 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 |