Método IDvdControl::ButtonSelectAndActivate (strmif.h)

[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.]

Nota A interface IDvdControl foi preterida. Use IDvdControl2 instread.

 

Seleciona e ativa o botão especificado.

Sintaxe

HRESULT ButtonSelectAndActivate(
  [in] ULONG ulButton
);

Parâmetros

[in] ulButton

Valor que especifica o botão que será selecionado e ativado, que deve ser de 1 a 36.

Retornar valor

Retorna um valor HRESULT .

Comentários

Os dispositivos de controle remoto eletrônico normalmente têm vários botões que ativam várias funções de uma unidade de reprodução de DVD. Normalmente, você chama esse método quando um usuário clica em um botão no dispositivo de controle; O DirectShow indica que o botão foi selecionado (reproduzindo um som ou alterando um gráfico, por exemplo) e chama métodos apropriados para qual botão foi selecionado, como ButtonActivate.

Esse método retorna um erro, a menos que o domínio seja DVD_DOMAIN_VideoManagerMenu, DVD_DOMAIN_VideoTitleSetMenu ou DVD_DOMAIN_Title. Para obter mais informações, consulte DVD_DOMAIN.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	strmif.h (inclua Dshow.h)

Confira também

Códigos de erro e êxito

IDvdControl Interface