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

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetCmdFromEvent método recupera un objeto IDvdCmd de un evento EC_DVD_CMD_START o EC_DVD_CMD_END .

Sintaxis

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

Parámetros

[in] lParam1

Parámetro lParam1 de la notificación de eventos.

[out] pCmdObj

Recibe un puntero a la interfaz IDvdCmd asociada al comando que desencadenó el evento.

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto	Descripción
S_OK	Correcto.
E_FAIL	El comando ya no existe.
E_POINTER	Argumento no válido.

Comentarios

Este método asigna el parámetro lParam1 de un evento de EC_DVD_CMD_START o EC_DVD_CMD_END en un objeto IDvdCmd asociado al comando que desencadenó el evento. A continuación, puede llamar a WaitForStart o WaitForEnd para controlar el comportamiento de bloqueo del navegador de DVD con respecto a ese comando. El navegador de DVD crea el objeto IDvdCmd y el puntero devuelto ya ha incrementado su recuento de referencias, por lo que debe liberarlo después de que WaitForStart o WaitForEnd devuelva.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdInfo2 (Interfaz)

Sincronizar comandos de DVD