Méthode IDvdInfo2 ::GetAllSPRMs (strmif.h)
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La méthode GetAllSPRMs récupère le contenu actuel de tous les registres de paramètres système (SPRM).
Syntaxe
HRESULT GetAllSPRMs(
[out] SPRMARRAY *pRegisterArray
);
Paramètres
[out] pRegisterArray
Pointeur vers un tableau de type SPRMARRAY qui reçoit l’adresse d’un tableau de sprms.
Valeur retournée
Retourne l’une des valeurs HRESULT suivantes.
| Code de retour | Description |
|---|---|
|
Réussite. |
|
Argument non valide. |
Notes
Les 24 modules SPRM sont utilisés pour stocker des informations sur la langue actuelle, la sous-image et d’autres données de navigation.
Note Une application de lecteur n’a pas besoin d’accéder à ces registres en lecture seule pour les fonctionnalités de navigation standard. Pour utiliser efficacement ces registres, vous aurez probablement besoin d’une connaissance plus détaillée des commandes de navigation sur DVD que celle fournie dans cette documentation. Le tableau suivant répertorie le contenu de chaque registre. Les bits du mot sont appelés b0 (bit d’ordre faible) à b15 (bit d’ordre élevé).
| S’inscrire | Contenu |
|---|---|
| 0 | Code de langue ISO-639 (deux lettres ASCII minuscules). La valeur par défaut n’est pas définie. |
| 1 | Les 4 bits faibles (b0-b3) contiennent le nombre de flux audio (0 à 7) ou 15 (aucun). La valeur par défaut est 15. |
| 2 | Les 6 bits faibles (b0-b5) contiennent le nombre de flux de sous-image (0 à 31) ou 62 (aucun) ou 63 (flux factice pour la sous-image forcée). Le 7e bit (b6) contient l’indicateur d’affichage de sous-image (0 = ne pas afficher la sous-image). La valeur par défaut est 62. |
| 3 | Les 4 bits bas (b0-b3) contiennent un nombre d’angle (1 à 9). La valeur par défaut est 1. |
| 4 | Les 7 bits bas (b0-b6) contiennent le numéro de titre (1 à 99). La valeur par défaut est 1. |
| 5 | Les 7 bits bas (b0-b6) contiennent le numéro de titre dans le VTS actuel (1 à 99). La valeur par défaut est 1. |
| 6 | Les 15 bits faibles (b0-b14) contiennent le nombre PGC dans le titre actuel (1 à 32767). La valeur par défaut n’est pas définie. |
| 7 | Les 10 bits faibles (b0-b9) contiennent le numéro de chapitre (1 à 99). La valeur par défaut est 1. Valeur non définie, sauf si title est one_sequential_PGC_title. |
| 8 | Les 6 bits élevés (b10-b15) contiennent le numéro de bouton (1 à 36). La valeur par défaut est 1024 (bouton 1). |
| 9 | Nombre de minuteurs, en secondes (0 à 65535). La valeur par défaut est 0. |
| 10 | Les 15 bits faibles (b0-b14) contiennent le nombre PGC dans le titre actuel (1 à 32767). La valeur par défaut n’est pas définie. |
| 11 | Six indicateurs (b2 : mix ch2 à ch1, b3 : mix ch3 à ch1, b4 : mix ch4 à ch1, b10 mix ch2 à ch0, b11 : mix ch3 à ch0, b12 : mix ch4 à ch0). La valeur de l’indicateur 0 signifie que ne pas mélanger. La valeur par défaut pour tous les indicateurs est 0. Valeur non définie si vous ne lisez pas le flux Karaoke. |
| 12 | Code pays/région ISO-3166 (deux lettres ASCII majuscules) ou 65535 (non spécifié). La valeur par défaut n’est pas définie. |
| 13 | Les 4 bits faibles (b0-b3) contiennent le niveau parental (1 à 8) ou 15 (aucun). La valeur par défaut n’est pas définie. |
| 14 | b8-b9 contiennent le mode de sortie vidéo actuel (0 = normal [4 :3 ou 16 :9], 1 = panscan, 2 = boîte aux lettres). b10-b11 contiennent le mode d’affichage préféré (0 = 4 :3, 3 = 16 :9). La valeur par défaut n’est pas définie. |
| 15 | Neuf indicateurs (b2 : karaoké SDDS, b3 : karaoké DTS, b4 : karaoké MPEG, b6 : karaoké Dolby Digital, b7 : karaoké PCM, b10 : lecture SDDS, b11 : lecture DTS, b12 : lecture MPEG, b14 : lecture Dolby Digital). La valeur de l’indicateur 0 signifie incapable, 1 signifie capable. La valeur par défaut n’est pas définie. |
| 16 | Code de langue ISO-639 (deux lettres ASCII minuscules) ou 65535 (non spécifié). La valeur par défaut est 65535. |
| 17 | Code d’extension de langage (0 = non spécifié, 1 = audio normal, 2 = audio pour les malvoyants, 3 = commentaires du directeur #1, 4 = commentaires du directeur #2). La valeur par défaut est 0. |
| 18 | Code de langue ISO-639 (deux lettres ASCII minuscules) ou 65535 (non spécifié). La valeur par défaut est 65535. |
| 19 | Code d’extension de langue (0 = non spécifié, 1 = sous-titres normaux, 2 = sous-titres volumineux, 3 = sous-titres pour les enfants, 5 = sous-titres normaux, 6 = sous-titres grands, 7 = sous-titres pour les enfants, 9 = sous-titres forcés, 13 = commentaires des directeurs, 14 = commentaires de grands directeurs, 15 = commentaires du directeur pour les enfants). La valeur par défaut est 0. |
| 20 | Les 8 bits bas (b0-b7) contiennent le code de région (1 à 8). |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | strmif.h (include Dshow.h) |
| Bibliothèque | Strmiids.lib |