IWMDMProgress ::P rogress, méthode (mswmdm.h)

Article
02/29/2024

La méthode Progress indique qu’une opération est toujours en cours.

Syntaxe

HRESULT Progress(
  [in] DWORD dwTranspiredTicks
);

Paramètres

[in] dwTranspiredTicks

DWORD spécifiant le nombre de graduations qui se sont produites jusqu’à présent.

Valeur retournée

L’application doit retourner l’une des valeurs HRESULT suivantes.

Code de retour	Description
S_OK	L’opération doit continuer.
WMDM_E_USER_CANCELLED	Les Gestionnaire de périphériques Windows Media doivent annuler l’opération en cours sans attendre qu’elle se termine. Si l’application utilise le mode bloc, Windows Media Gestionnaire de périphériques retourne cette erreur à l’application.

Remarques

Cette méthode est appelée par toutes les autres méthodes windows Media Gestionnaire de périphériques. L’objectif est que Progress soit appelé une fois par tick estimé. Toutefois, le paramètre dwTranspiredTicks doit être vérifié à chaque appel, car l’opération en cours d’exécution peut ne pas garantir un appel une fois pour chaque graduation estimée.

L’application retourne S_OK à la méthode appelante pour indiquer que l’opération doit continuer. L’application retourne WMDM_E_USER_CANCELLED pour indiquer que l’opération doit être annulée. Si l’application utilise le mode bloc et retourne WMDM_E_USER_CANCELLED, Windows Media Gestionnaire de périphériques retourne cette même erreur à l’application.

Exemples

Le code C++ suivant est une implémentation simple de la méthode Progress .


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