Compartilhar via

Método IDvdControl2::ActivateAtPosition (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 ActivateAtPosition método ativa o botão de menu sob a posição do ponteiro do mouse.

Sintaxe

HRESULT ActivateAtPosition(
  [in] POINT point
);

Parâmetros

[in] point

Aponte para a área da janela do cliente, em coordenadas de pixel de tela.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
 O clique ocorreu no retângulo de botão realçado e o botão foi ativado com êxito.
E_INVALIDARG
 O ponto está fora da região de vídeo válida.
E_UNEXPECTED
 O botão está presente, mas não está funcionando.
VFW_E_DVD_INVALIDDOMAIN
 O Navegador de DVD não está em um domínio de menu.
VFW_E_DVD_NO_BUTTON
 Não há nenhum botão de menu sob a posição do ponteiro do mouse.
VFW_E_DVD_OPERATION_INHIBITED
 A operação é inibida pelo controle de UOP (operação do usuário).

Comentários

As coordenadas do ponteiro do mouse são relativas ao canto superior esquerdo da área do cliente, que não é necessariamente a área de exibição de vídeo se o vídeo estiver no formato de caixa de correio.

Use esse método quando o usuário estiver navegando por um menu movendo o ponteiro do mouse diretamente sobre os botões do menu. Se o usuário estiver usando os botões relativos para navegar no menu, use ActivateButton em vez de ActivateAtPosition.

A tabela a seguir mostra o nome do comando Anexo J ao qual esse nome de método corresponde e os domínios nos quais esse método é válido.

Nome do comando Anexo J Domínios válidos
Nenhum
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu

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

IDvdControl2 Interface

Trabalhando com menus de DVD