IWMDMProgress ::Begin, méthode (mswmdm.h)

Article
02/29/2024

La méthode Begin indique qu’une opération commence. Une estimation de la durée de l’opération est fournie lorsque cela est possible.

Syntaxe

HRESULT Begin(
  [in] DWORD dwEstimatedTicks
);

Paramètres

[in] dwEstimatedTicks

DWORD spécifiant le nombre estimé de graduations nécessaires à la fin de l’opération.

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	Windows Media Gestionnaire de périphériques doit 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 opération est appelée par différentes méthodes pour indiquer qu’une opération commence. Le nombre de graduations passées dans dwEstimatedTicks est une estimation du nombre de ticks nécessaires pour que l’opération se termine. Au cours de l’opération, la méthode Progress est appelée pour indiquer le nombre de tiques qui se sont produites. Les applications peuvent utiliser l’estimation pour configurer des mécanismes d’affichage qui indiquent la progression.

La méthode IWMDMProgress3 ::Begin3 fournit plus d’informations sur l’action qui se produit.

Exemples

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


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