Méthode IDvdControl2 ::SetGPRM (strmif.h)

Article
03/06/2024

[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 SetGPRM méthode définit une valeur de registre de paramètre général.

Syntaxe

HRESULT SetGPRM(
  [in]  ULONG   ulIndex,
  [in]  WORD    wValue,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Paramètres

[in] ulIndex

Inscrire l’index ; peut être une valeur comprise entre zéro et 15.

[in] wValue

Valeur 16 bits contenue dans le registre spécifié.

[in] dwFlags

OR au niveau du bit d’un ou de plusieurs indicateurs de l’énumération DVD_CMD_FLAGS , en spécifiant comment synchroniser la commande.

[out] ppCmd

Reçoit un pointeur vers un objet IDvdCmd qui peut être utilisé pour synchroniser des commandes DVD. L’appelant doit libérer l’interface. Ce paramètre peut être NULL. Pour plus d’informations, consultez Synchronisation des commandes DVD.

Valeur retournée

Retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	Le paramètre ulIndex est supérieur à 15 ou tout autre paramètre d’entrée n’est pas valide.

Remarques

Un disque DVD utilise des registres de paramètres généraux pour stocker différents types d’informations. En définissant manuellement un ou plusieurs de ces registres, une application peut être en mesure de fournir certaines fonctionnalités personnalisées. Il s’agit d’une commande avancée qui ne doit pas être utilisée, sauf si vous avez une compréhension approfondie de la spécification du DVD.

Le tableau suivant indique le nom de la commande Annexe J auquel ce nom de méthode correspond et les domaines dans lesquels cette méthode est valide.

Nom de la commande Annexe J	Domaines valides
aucun	Tous

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

Voir aussi

DVD Applications

Codes d’erreur et de réussite

IDvdControl2, interface

IDvdInfo2 ::GetAllGPRMs

Partager via