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

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetCurrentUOPS método recupera un conjunto de marcas que indican qué comandos de navegación, si existen, los autores de contenido se han deshabilitado explícitamente para la ubicación del disco actual.

Sintaxis

HRESULT GetCurrentUOPS(
  [out] ULONG *pulUOPs
);

Parámetros

[out] pulUOPs

Recibe valores de VALID_UOP_FLAG bit a bit. Cada bit representa el estado (válido o no válido) de una operación de usuario (UOP). Si se establece el bit, se prohíbe esa operación de usuario. Vea la sección Comentarios.

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	pulUOPs no es un puntero válido.

Comentarios

Los autores de DVD pueden insertar comandos UOP en casi cualquier lugar del disco para no permitir un comando de navegación que, de lo contrario, se permitiría dentro del dominio de DVD actual. En otras palabras, los comandos UOP permiten a los autores de discos invalidar los permisos de navegación habituales.

Normalmente, una aplicación del reproductor de DVD nunca debe tener que usar este método porque el navegador de DVD comprueba automáticamente todos los permisos UOP antes de continuar con cualquier comando, y devolverá VFW_E_DVD_OPERATION_INHIBITED desde cualquier método si el comando no es válido en el UOP actual. Si la aplicación necesita realizar un seguimiento de los permisos de UOP actuales, puede llamar GetCurrentUOPS cada vez que se requieran los permisos de UOP actuales, o puede controlar la notificación de eventos de EC_DVD_VALID_UOPS_CHANGE en el bucle de mensajes y recuperar la información de UOP del parámetro lParam1 . Este último enfoque suele ser más eficaz.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)
Library	Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdInfo2 (interfaz)