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
S_OK
Operazione completata.
E_POINTER
Argomento non valido.
E_UNEXPECTED
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

Vedi anche

Applicazioni DVD

Codici errore e esito positivo

Interfaccia IInfo2

Uso delle stringhe di testo DVD