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

Artigo
03/05/2024

[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 GetCurrentAngle método recupera o número de ângulos disponíveis no bloco angular atual e o número angular selecionado no momento.

Sintaxe

HRESULT GetCurrentAngle(
  [out] ULONG *pulAnglesAvailable,
  [out] ULONG *pulCurrentAngle
);

Parâmetros

[out] pulAnglesAvailable

Recebe o número de ângulos disponíveis. Há até nove ângulos em um bloco angular, numerados de 1 a 9. Se o valor for igual a 1, o Navegador de DVD não estará em um bloco angular.

[out] pulCurrentAngle

Recebe o número do ângulo atual.

Retornar valor

Retorna um dos seguintes valores HRESULT .

Código de retorno	Descrição
S_OK	Êxito.
E_POINTER	Argumento inválido.
VFW_E_DVD_INVALIDDOMAIN	O Navegador de DVD não é inicializado ou não está em um domínio válido.

Comentários

Observe que os índices de botão angular e de menu são baseados em 1, enquanto os índices de fluxo de áudio e subpictura são baseados em 0. Quando o Navegador de DVD está prestes a inserir um bloco angular, ele envia ao aplicativo uma notificação de evento EC_DVD_ANGLES_AVAILABLE com o lParam definido como 1. Os aplicativos normalmente chamarão GetCurrentAngle e IDvdControl2::SelectAngle dentro de seu manipulador de eventos para EC_DVD_ANGLES_AVAILABLE.

Esse método é demonstrado no aplicativo DVDSample em CAngleDlg::MakeAngleList.

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