Método IWMDMProgress::P rogress (mswmdm.h)

Artículo
03/05/2024

El método Progress indica que una operación todavía está en curso.

Sintaxis

HRESULT Progress(
  [in] DWORD dwTranspiredTicks
);

Parámetros

[in] dwTranspiredTicks

DWORD especificando el número de tics que han transcurrido hasta ahora.

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

El resto de métodos de Windows Media Administrador de dispositivos llama a este método. La intención es que se llame a Progress una vez por tic estimado. Sin embargo, el parámetro dwTranspiredTicks debe comprobarse en cada llamada porque la operación que se realiza puede no garantizar una llamada una vez para cada tic estimado.

La aplicación devuelve S_OK al método de llamada para indicar que la operación debe continuar. La aplicación devuelve 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++ es una implementación sencilla del método Progress .


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