Metodo IWMDMProgress::P rogress (mswmdm.h)

Articolo
02/29/2024

Il metodo Progress indica che un'operazione è ancora in corso.

Sintassi

HRESULT Progress(
  [in] DWORD dwTranspiredTicks
);

Parametri

[in] dwTranspiredTicks

DWORD che specifica il numero di zecche che hanno traspirato finora.

Valore restituito

L'applicazione deve restituire uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	L'operazione deve continuare.
WMDM_E_USER_CANCELLED	Windows Media Gestione dispositivi deve annullare l'operazione corrente senza attendere il completamento. Se l'applicazione usa la modalità di blocco, Windows Media Gestione dispositivi restituirà questo errore all'applicazione.

Commenti

Questo metodo viene chiamato da tutti gli altri metodi di Gestione dispositivi Windows Media. L'intenzione è che lo stato di avanzamento verrà chiamato una volta per ogni segno di spunta stimato. Tuttavia, il parametro dwTranspiredTicks deve essere controllato in ogni chiamata perché l'operazione eseguita potrebbe non garantire una chiamata una volta per ogni segno di spunta stimato.

L'applicazione restituisce S_OK al metodo chiamante per indicare che l'operazione deve continuare. L'applicazione restituisce WMDM_E_USER_CANCELLED per indicare che l'operazione deve essere annullata. Se l'applicazione usa la modalità di blocco e restituisce WMDM_E_USER_CANCELLED, windows Media Gestione dispositivi restituirà lo stesso errore all'applicazione.

Esempio

Il codice C++ seguente è una semplice implementazione del metodo Progress .


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