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

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O GetCurrentUOPS método recupera um conjunto de sinalizadores indicando quais comandos de navegação, se houver, os autores de conteúdo desabilitaram explicitamente para o local do disco atual.

Sintaxe

HRESULT GetCurrentUOPS(
  [out] ULONG *pulUOPs
);

Parâmetros

[out] pulUOPs

Recebe valores de VALID_UOP_FLAG bit a bit. Cada bit representa o estado (válido ou não válido) de uma UOP (operação de usuário). Se o bit estiver definido, essa operação de usuário será proibida. Consulte Observações.

Valor retornado

Retorna um dos seguintes valores HRESULT .

Código de retorno	Descrição
S_OK	Êxito.
E_POINTER	pulUOPs não é um ponteiro válido.

Comentários

Os autores de DVD podem inserir comandos UOP em quase qualquer lugar no disco para não permitir um comando de navegação que, de outra forma, seria permitido dentro do domínio de DVD atual. Em outras palavras, os comandos UOP permitem que os autores de disco substituam as permissões de navegação usuais.

Um aplicativo dvd player normalmente nunca deve usar esse método porque o DVD Navigator verifica automaticamente todas as permissões de UOP antes de prosseguir com qualquer comando e retornará VFW_E_DVD_OPERATION_INHIBITED de qualquer método se o comando for inválido na UOP atual. Se o aplicativo precisar acompanhar as permissões atuais de UOP em si, você poderá chamar GetCurrentUOPS sempre que as permissões atuais de UOP forem necessárias ou manipular a notificação de evento EC_DVD_VALID_UOPS_CHANGE no loop de mensagem e recuperar as informações de UOP do parâmetro lParam1 . A última abordagem geralmente é mais eficiente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	strmif.h (inclua Dshow.h)
Biblioteca	Strmiids.lib

Confira também

Aplicativos DE DVD

Códigos de erro e êxito

IDvdInfo2 Interface