Metodo IConfigurationInfo2::GetCurrentUOPS (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetCurrentUOPS metodo recupera un set di flag che indicano quali comandi di navigazione, se presenti, gli autori del contenuto hanno disabilitato in modo esplicito per il percorso del disco corrente.

Sintassi

HRESULT GetCurrentUOPS(
  [out] ULONG *pulUOPs
);

Parametri

[out] pulUOPs

Riceve un valore VALID_UOP_FLAG bit per bit. Ogni bit rappresenta lo stato (valido o non valido) di un'operazione utente (UOP). Se il bit è impostato, l'operazione utente non è consentita. Vedere la sezione Osservazioni.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito Descrizione
S_OK
Operazione completata.
E_POINTER
pulUOPs non è un puntatore valido.

Commenti

Gli autori di DVD possono inserire comandi UOP in quasi qualsiasi posizione sul disco per impedire un comando di navigazione che altrimenti sarebbe consentito all'interno del dominio DVD corrente. In altre parole, i comandi UOP consentono agli autori di dischi di eseguire l'override delle normali autorizzazioni di spostamento.

Un'applicazione lettore DVD in genere non deve mai usare questo metodo perché lo strumento di navigazione DVD controlla automaticamente tutte le autorizzazioni UOP prima di procedere con qualsiasi comando e restituirà VFW_E_DVD_OPERATION_INHIBITED da qualsiasi metodo se il comando non è valido nell'UOP corrente. Se l'applicazione deve tenere traccia delle autorizzazioni UOP correnti, è possibile chiamare GetCurrentUOPS ogni volta che sono necessarie le autorizzazioni UOP correnti oppure è possibile gestire la notifica degli eventi EC_DVD_VALID_UOPS_CHANGE nel ciclo di messaggi e recuperare le informazioni UOP dal parametro lParam1 . Quest'ultimo approccio è in genere più efficiente.

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 di errore e di esito positivo

Interfaccia IInfo2