Método IWMDMProgress::Begin (mswmdm.h)

Artículo
02/29/2024

El método Begin indica que se está iniciando una operación. Cuando sea posible, se proporciona una estimación de la duración de la operación.

Sintaxis

HRESULT Begin(
  [in] DWORD dwEstimatedTicks
);

Parámetros

[in] dwEstimatedTicks

DWORD que especifica el número estimado de tics necesarios para que se complete la operación.

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

Varios métodos llaman a esta operación para indicar que se está iniciando una 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 Progress para indicar cuántos tics han transcurrido. Las aplicaciones pueden usar la estimación para configurar mecanismos de visualización que muestran el progreso.

El método IWMDMProgress3::Begin3 proporciona más información sobre qué acción se está produciendo.

Ejemplos

El siguiente código de C++ es una implementación del método Begin .


HRESULT Begin(DWORD  dwEstimatedTicks)
{
    // TODO: Display the message: "IWMDMProgress::Begin called.: "
    // followed by the dwEstimatedTicks value.
    return S_OK;
}