Compartilhar via


Método IDvdInfo2::GetCmdFromEvent (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 GetCmdFromEvent método recupera um objeto IDvdCmd de um evento EC_DVD_CMD_START ou EC_DVD_CMD_END .

Sintaxe

HRESULT GetCmdFromEvent(
  [in]  LONG_PTR lParam1,
  [out] IDvdCmd  **pCmdObj
);

Parâmetros

[in] lParam1

Parâmetro lParam1 da notificação de evento.

[out] pCmdObj

Recebe um ponteiro para a interface IDvdCmd associada ao comando que disparou o evento.

Retornar valor

Retorna um dos seguintes valores HRESULT .

Código de retorno Descrição
S_OK
Êxito.
E_FAIL
O comando não existe mais.
E_POINTER
Argumento inválido.

Comentários

Esse método mapeia o parâmetro lParam1 de um evento EC_DVD_CMD_START ou EC_DVD_CMD_END em um objeto IDvdCmd associado ao comando que disparou o evento. Em seguida, você pode chamar WaitForStart ou WaitForEnd para controlar o comportamento de bloqueio do Navegador de DVD em relação a esse comando. O objeto IDvdCmd é criado pelo Navegador de DVD e o ponteiro retornado já teve sua contagem de referência incrementada, portanto, você deve liberá-lo após o retorno de WaitForStart ou WaitForEnd .

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

Sincronizando comandos de DVD