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

Artigo
02/29/2024

O método Progress indica que uma operação ainda está em andamento.

Sintaxe

HRESULT Progress(
  [in] DWORD dwTranspiredTicks
);

Parâmetros

[in] dwTranspiredTicks

DWORD especificando o número de tiques que ocorreram até agora.

Retornar valor

O aplicativo deve retornar um dos seguintes valores HRESULT .

Código de retorno	Descrição
S_OK	A operação deve continuar.
WMDM_E_USER_CANCELLED	Os Gerenciador de Dispositivos do Windows Media devem cancelar a operação atual sem esperar que ela seja concluída. Se o aplicativo estiver usando o modo de bloco, o Gerenciador de Dispositivos do Windows Media retornará esse erro ao aplicativo.

Comentários

Esse método é chamado por todos os outros métodos de Gerenciador de Dispositivos do Windows Media. A intenção é que o Progresso seja chamado uma vez por tique estimado. No entanto, o parâmetro dwTranspiredTicks deve ser verificado em cada chamada porque a operação que está sendo executada pode não garantir uma chamada uma vez para cada tique estimado.

O aplicativo retorna S_OK ao método de chamada para indicar que a operação deve continuar. O aplicativo retorna WMDM_E_USER_CANCELLED para indicar que a operação deve ser cancelada. Se o aplicativo estiver usando o modo de bloco e retornar WMDM_E_USER_CANCELLED, o Windows Media Gerenciador de Dispositivos retornará esse mesmo erro ao aplicativo.

Exemplos

O código C++ a seguir é uma implementação simples do método Progress .


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