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

Artículo
03/09/2024

Windows Media llama al método Begin3 Administrador de dispositivos para indicar que una operación está a punto de comenzar. Cuando sea posible, se proporciona una estimación de la duración de la operación. Este método extiende IWMDMProgress::Begin proporcionando parámetros de entrada adicionales para la identificación (ID) del evento y para un puntero al contexto opcional de los comandos. La operación se identifica mediante un identificador de evento. El método permite al autor de la llamada pasar una estructura de datos opaca a la aplicación.

Sintaxis

HRESULT Begin3(
  [in]      GUID          EventId,
  [in]      DWORD         dwEstimatedTicks,
  [in, out] OPAQUECOMMAND *pContext
);

Parámetros

[in] EventId

GUID que identifica la operación que se iniciará. En la siguiente tabla se muestran los valores posibles.

Evento	Descripción
SCP_EVENTID_ACQSECURECLOCK	Windows Media Administrador de dispositivos adquiere un reloj seguro desde el 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, OPAQUECOMMAND especifica 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] dwEstimatedTicks

DWORD que especifica el número estimado de tics necesarios para que se complete la operación. El número de tics pasados en dwEstimatedTicks es una estimación del número de tics necesarios para que se complete la operación. Durante el curso de la operación, se llama al método Progress3 para indicar cuántos tics han transcurrido. Las aplicaciones pueden usar la estimación para configurar mecanismos de visualización que muestran el progreso.

[in, out] pContext

Puntero a una estructura OPAQUECOMMAND que contiene un comando enviado al dispositivo sin ser controlado por Windows Media Administrador de dispositivos. Este parámetro es opcional y puede ser NULL.

Valor devuelto

La aplicación debe devolver uno de los siguientes valores HRESULT .

Código devuelto	Descripción
S_OK	La operación debe continuar.
WMDM_E_USER_CANCELLED	Windows Media Administrador de dispositivos debe cancelar la operación actual sin esperar a que finalice. Si la aplicación usa el modo de bloqueo, Windows Media Administrador de dispositivos devolverá este error a la aplicación.

Comentarios

La aplicación devuelve S_OK para indicar que se debe continuar una operación y WMDM_E_USER_CANCELLED para indicar que se debe cancelar la operación. Si la aplicación usa el modo de bloqueo y devuelve WMDM_E_USER_CANCELLED, Windows Media Administrador de dispositivos devolverá este mismo error a la aplicación.

Ejemplos

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


HRESULT Begin3(GUID  EventId, DWORD  dwEstimatedTicks, OPAQUECOMMAND*  pContext)
{
    WCHAR strGuid[64];
    StringFromGUID2(reinterpret_cast<GUID&>(EventId),(LPOLESTR)strGuid, 64);
    // TODO: Display the message "IWMDMProgress3::Begin3 called." 
    // followed by the strGuid value.
    return S_OK;
}