Méthode IDvdInfo2 ::GetCurrentUOPS (strmif.h)

  • Article

[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 GetCurrentUOPS méthode récupère un ensemble d’indicateurs indiquant quelles commandes de navigation, le cas échéant, les auteurs de contenu ont explicitement désactivées pour l’emplacement actuel du disque.

Syntaxe

HRESULT GetCurrentUOPS(
  [out] ULONG *pulUOPs
);

Paramètres

[out] pulUOPs

Reçoit des valeurs de VALID_UOP_FLAG au niveau du bit. Chaque bit représente l’état (valide ou non) d’une opération utilisateur (UOP). Si le bit est défini, cette opération utilisateur est interdite. Consultez la section Notes.

Valeur de retour

Retourne l’une des valeurs HRESULT suivantes.

Code de retour Description
S_OK
 Réussite.
E_POINTER
 pulUOPs n’est pas un pointeur valide.

Remarques

Les auteurs de DVD peuvent insérer des commandes UOP à presque n’importe quel emplacement sur le disque pour interdire une commande de navigation qui serait autrement autorisée dans le domaine DVD actuel. En d’autres termes, les commandes UOP permettent aux auteurs de disques de remplacer les autorisations de navigation habituelles.

Une application de lecteur DE DVD ne doit normalement jamais avoir à utiliser cette méthode, car le Navigateur de DVD vérifie automatiquement toutes les autorisations UOP avant de continuer avec une commande, et retourne VFW_E_DVD_OPERATION_INHIBITED à partir d’une méthode si la commande n’est pas valide dans l’UOP actuelle. Si votre application doit suivre les autorisations UOP actuelles, vous pouvez appeler GetCurrentUOPS chaque fois que les autorisations UOP actuelles sont requises, ou vous pouvez gérer la notification d’événement EC_DVD_VALID_UOPS_CHANGE dans votre boucle de message et récupérer les informations UOP à partir du paramètre lParam1 . Cette dernière approche est généralement plus efficace.

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

IDvdInfo2, interface