Método IWMDMProgress3::End3 (mswmdm.h)

Artículo
02/29/2024

Windows Media llama al método End3 Administrador de dispositivos para indicar que ha finalizado una operación. Este método extiende IWMDMProgress2::End2 proporcionando parámetros de entrada adicionales para la identificación (ID) del evento y para un puntero al contexto de los comandos.

Sintaxis

HRESULT End3(
  [in]      GUID          EventId,
  [in]      HRESULT       hrCompletionCode,
  [in, out] OPAQUECOMMAND *pContext
);

Parámetros

[in] EventId

GUID que especifica el evento que termina. En la siguiente tabla se muestran los valores posibles.

Evento	Descripción
SCP_EVENTID_ACQSECURECLOCK	Windows Media Administrador de dispositivos está obteniendo un reloj seguro del servidor.
SCP_EVENTID_NEEDTOINDIV	El dispositivo se está individualizando. Actualmente no se usa.
SCP_EVENTID_DRMINFO	Este identificador de evento se usa para notificar a la aplicación el encabezado DRM de versión que se encuentra en el contenido de cada archivo. La estructura OPAQUECOMMAND devuelta tiene el miembro guidCommand establecido en SCP_PARAMID_DRMVERSION. Además, los datos especifican una de las marcas siguientes: WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	El contenido se transfiere a o desde el dispositivo.

[in] hrCompletionCode

HRESULT especificando el código de finalización de la operación en curso. El parámetro hrCompletionCode es el código de retorno de la operación que finalizó. Este parámetro puede ser cualquier HRESULT, incluidos los códigos de error COM estándar, los códigos de error win32 convertidos en HRESULT o windows Media Administrador de dispositivos códigos de error.

[in, out] pContext

Puntero a una estructura OPAQUECOMMAND que contiene un comando enviado directamente al dispositivo sin ser controlado por Windows Media Administrador de dispositivos. Este parámetro es opcional y puede ser NULL. La estructura de contexto es una manera de que el componente envíe los datos pertinentes con el evento a la aplicación. El componente que envía esta estructura debe definir cómo la aplicación puede interpretar esta estructura de datos.

Valor devuelto

Windows Media Administrador de dispositivos omite cualquier código devuelto devuelto por el método End3 porque la operación actual ha finalizado o cancelado antes de llamar a este método.

Comentarios

La interfaz que posee el método que implementa una operación llama a End3 cuando se completa la operación definida por el método.

Ejemplos

El siguiente código de C++ muestra una implementación de ejemplo de End3.


HRESULT End3(GUID  EventId, HRESULT  hrCompletionCode, OPAQUECOMMAND*  pContext)
{
    // TODO: Display the message "IWMDMProgress3::End3 called."
    return S_OK;
}