Metodo IDeviceInfo2::GetAllSPRMs (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 metodo GetAllSPRMs recupera il contenuto corrente di tutti i registri dei parametri di sistema (SPRMs).

Sintassi

HRESULT GetAllSPRMs(
  [out] SPRMARRAY *pRegisterArray
);

Parametri

[out] pRegisterArray

Puntatore a una matrice di tipo SPRMARRAY che riceve l'indirizzo di una matrice di SPRMs.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito Descrizione
S_OK
Operazione completata.
E_POINTER
Argomento non valido.

Commenti

I 24 SPRMs vengono usati per contenere informazioni sulla lingua corrente, la sottopicture e altri dati di spostamento.

Nota Un'applicazione lettore non deve accedere a questi registri di sola lettura per qualsiasi funzionalità di spostamento standard. Per usare questi registri in modo efficace, probabilmente è necessaria una conoscenza più dettagliata dei comandi di spostamento DVD che sono disponibili in questa documentazione. La tabella seguente elenca il contenuto di ogni registro. I bit all'interno della parola vengono definiti b0 (bit di ordine basso) tramite b15 (bit di ordine elevato).
 
Registrazione Contenuto
0 Codice del linguaggio ISO-639 (due lettere ASCII minuscole). Il valore predefinito non è definito.
1 I 4 bit bassi (b0-b3) contengono il numero di flusso audio (da 0 a 7) o 15 (nessuno). Il valore predefinito è 15.
2 I 6 bit bassi (b0-b5) contengono il numero di flusso di sottopicture (da 0 a 31) o 62 (nessuno) o 63 (flusso fittizio per la sottopictura forzata). 7 ° bit (b6) contiene flag di visualizzazione sottopicture (0 = non visualizzare sottopicture). Il valore predefinito è 62.
3 I 4 bit bassi (b0-b3) contengono il numero di angolo (da 1 a 9). Il valore predefinito è 1.
4 I 7 bit bassi (b0-b6) contengono il numero di titolo (da 1 a 99). Il valore predefinito è 1.
5 I 7 bit bassi (b0-b6) contengono il numero di titolo all'interno di VTS corrente (da 1 a 99). Il valore predefinito è 1.
6 I 15 bit bassi (b0-b14) contengono il numero PGC nel titolo corrente (da 1 a 32767). Il valore predefinito non è definito.
7 I 10 bit bassi (b0-b9) contengono il numero di capitolo (da 1 a 99). Il valore predefinito è 1. Valore non definito a meno che il titolo non sia one_sequential_PGC_title.
8 I 6 bit elevati (b10-b15) contengono il numero di pulsanti (da 1 a 36). Il valore predefinito è 1024 (pulsante 1).
9 Conteggio timer, in secondi (da 0 a 65535). Il valore predefinito è 0.
10 I 15 bit bassi (b0-b14) contengono il numero PGC nel titolo corrente (da 1 a 32767). Il valore predefinito non è definito.
11 Sei flag (b2: mix ch2 to ch1, b3: mix ch3 to ch1, b4: mix ch4 to ch1, b10 mix ch2 to ch0, b11: mix ch3 to ch0, b12: mix ch4 to ch0). Il valore del flag pari a 0 significa non combinare. Il valore predefinito per tutti i flag è 0. Valore non definito se non si gioca il flusso Karaoke.
12 Codice paese/area geografica ISO-3166 (due lettere ASCII maiuscole) o 65535 (non specificato). Il valore predefinito non è definito.
13 I 4 bit bassi (b0-b3) contengono il livello dei genitori (da 1 a 8) o 15 (nessuno). Il valore predefinito non è definito.
14 b8-b9 contiene la modalità di output video corrente (0 = normale [4:3 o 16:9], 1 = panscan, 2 = casella di lettere). b10-b11 contiene la modalità di visualizzazione preferita (0 = 4:3, 3 = 16:9). Il valore predefinito non è definito.
15 Nove flag (b2: karaoke SDDS, b3: karaoke DTS, b4: MPEG karaoke, b6: Dolby Digital karaoke, b7: PCM karaoke, b10: riproduzione SDDS, b11: riproduzione DTS, b12: riproduzione MPEG, b14: riproduzione Dolby Digital). Il valore del flag di 0 significa incapace, 1 significa in grado. Il valore predefinito non è definito.
16 Codice del linguaggio ISO-639 (due lettere ASCII minuscole) o 65535 (non specificato). Il valore predefinito è 65535.
17 Codice di estensione del linguaggio (0 = non specificato, 1 = audio normale, 2 = audio per gli oggetti visivamente compromessi, 3 = commenti del direttore #1, 4 = commenti di director #2). Il valore predefinito è 0.
18 Codice del linguaggio ISO-639 (due lettere ASCII minuscole) o 65535 (non specificato). Il valore predefinito è 65535.
19 Codice di estensione del linguaggio (0 = non specificato, 1 = sottotitoli normali, 2 = sottotitoli di grandi dimensioni, 3 = sottotitoli per bambini, 5 = normali didascalie chiuse, 6 = didascalie chiuse, 7 = sottotitoli chiusi per bambini, 9 = sottotitoli forzati, 13 = commenti del direttore, 14 = commenti di grandi dimensioni, 15 = commenti del direttore per bambini). Il valore predefinito è 0.
20 I 8 bit bassi (b0-b7) contengono codice area (da 1 a 8).

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