IDvdInfo2::GetAllSPRMs-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die GetAllSPRMs-Methode ruft den aktuellen Inhalt aller Systemparameterregister (SPRMs) ab.
Syntax
HRESULT GetAllSPRMs(
[out] SPRMARRAY *pRegisterArray
);
Parameter
[out] pRegisterArray
Zeiger auf ein Array vom Typ SPRMARRAY , das die Adresse eines Arrays von SPRMs empfängt.
Rückgabewert
Gibt einen der folgenden HRESULT-Werte zurück.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Ungültiges Argument. |
Hinweise
Die 24 SPRMs werden verwendet, um Informationen zur aktuellen Sprache, zur Subpicture und zu anderen Navigationsdaten zu enthalten.
Hinweis Eine Playeranwendung muss nicht auf diese schreibgeschützten Register für Standardnavigationsfunktionen zugreifen. Um diese Register effektiv zu verwenden, benötigen Sie wahrscheinlich detailliertere Kenntnisse der DVD-Navigationsbefehle als in dieser Dokumentation. In der folgenden Tabelle sind die Inhalte der einzelnen Register aufgeführt. Bits innerhalb des Worts werden als b0 (Bit niedriger Ordnung) bis b15 (Bit hoher Ordnung) bezeichnet.
| Registrieren | Inhalte |
|---|---|
| 0 | ISO-639-Sprachcode (zwei ASCII-Kleinbuchstaben). Der Standardwert ist undefiniert. |
| 1 | Niedrige 4 Bits (b0-b3) enthalten die Audiodatenstromnummer (0 bis 7) oder 15 (keine). Standardwert: 15. |
| 2 | Niedrige 6 Bits (b0-b5) enthalten die Unterpicturstromnummer (0 bis 31) oder 62 (keine) oder 63 (Dummystream für erzwungene Unterpicture). 7. Bit (b6) enthält unterpicture display flag (0 = don't display subpicture). Der Standardwert ist 62. |
| 3 | Niedrige 4 Bits (b0-b3) enthalten die Winkelzahl (1 bis 9). Der Standardwert ist 1. |
| 4 | Niedrige 7 Bits (b0-b6) enthalten die Titelnummer (1 bis 99). Der Standardwert ist 1. |
| 5 | Niedrige 7 Bits (b0-b6) enthalten die Titelnummer innerhalb der aktuellen VTS (1 bis 99). Der Standardwert ist 1. |
| 6 | Niedrige 15 Bits (b0-b14) enthalten PGC-Nummer im aktuellen Titel (1 bis 32767). Der Standardwert ist undefiniert. |
| 7 | Niedrige 10 Bits (b0-b9) enthalten die Kapitelnummer (1 bis 99). Der Standardwert ist 1. Wert undefiniert, es sei denn, titel ist one_sequential_PGC_title. |
| 8 | Hohe 6 Bits (b10-b15) enthalten die Schaltflächennummer (1 bis 36). Der Standardwert ist 1024 (Schaltfläche 1). |
| 9 | Timeranzahl in Sekunden (0 bis 65535). Der Standardwert ist 0. |
| 10 | Niedrige 15 Bits (b0-b14) enthalten PGC-Nummer im aktuellen Titel (1 bis 32767). Der Standardwert ist undefiniert. |
| 11 | Sechs Flags (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). Der Flagwert 0 bedeutet nicht mischen. Der Standardwert für alle Flags ist 0. Wert undefiniert, wenn der Karaoke-Stream nicht wiedergegeben wird. |
| 12 | ISO-3166-Länder-/Regionscode (zwei ASCII-Großbuchstaben) oder 65535 (nicht angegeben). Der Standardwert ist undefiniert. |
| 13 | Niedrige 4 Bits (b0-b3) enthalten Elternebene (1 bis 8) oder 15 (keine). Der Standardwert ist undefiniert. |
| 14 | b8-b9 enthalten den aktuellen Videoausgabemodus (0 = normal [4:3 oder 16:9], 1 = Panscan, 2 = Briefkasten). b10-b11 enthalten den bevorzugten Anzeigemodus (0 = 4:3, 3 = 16:9). Der Standardwert ist undefiniert. |
| 15 | Neun Flaggen (b2: SDDS-Karaoke, b3: DTS-Karaoke, b4: MPEG-Karaoke, b6: Dolby Digital-Karaoke, b7: PCM-Karaoke, b10: SDDS-Wiedergabe, b11: DTS-Wiedergabe, b12: MPEG-Wiedergabe, b14: Dolby Digital-Wiedergabe). Der Flagwert 0 bedeutet unfähig, 1 bedeutet fähig. Der Standardwert ist undefiniert. |
| 16 | ISO-639-Sprachcode (zwei ASCII-Kleinbuchstaben) oder 65535 (nicht angegeben). Der Standardwert ist 65535. |
| 17 | Spracherweiterungscode (0 = nicht angegeben, 1 = normale Audio, 2 = Audio für Sehbehinderte, 3 = Director-Kommentare #1, 4 = Director-Kommentare #2). Der Standardwert ist 0. |
| 18 | ISO-639-Sprachcode (zwei ASCII-Kleinbuchstaben) oder 65535 (nicht angegeben). Der Standardwert ist 65535. |
| 19 | Spracherweiterungscode (0 = nicht angegeben, 1 = normale Untertitel, 2 = große Untertitel, 3 = Untertitel für Kinder, 5 = normale Untertitel, 6 = große Untertitel, 7 = Untertitel für Kinder, 9 = untertitelte Untertitel, 13 = Regiekommentare, 14 = große Regisseurskommentare, 15 = Regisseurskommentare für Kinder). Der Standardwert ist 0. |
| 20 | Niedrige 8 Bits (b0-b7) enthalten Regionscode (1 bis 8). |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |