Metodo IWMDMProgress::Begin (mswmdm.h)

Articolo
02/29/2024

Il metodo Begin indica che un'operazione inizia. Quando possibile, viene fornita una stima della durata dell'operazione.

Sintassi

HRESULT Begin(
  [in] DWORD dwEstimatedTicks
);

Parametri

[in] dwEstimatedTicks

DWORD che specifica il numero stimato di tick necessari per il completamento dell'operazione.

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à blocco, Windows Media Gestione dispositivi restituirà questo errore all'applicazione.

Commenti

Questa operazione viene chiamata da vari metodi per indicare che un'operazione inizia. Il numero di tick passati in dwEstimatedTicks è una stima del numero di tick necessari per il completamento dell'operazione. Durante l'operazione, viene chiamato il metodo Progress per indicare il numero di segni di graduazione rilevati. Le applicazioni possono usare la stima per configurare i meccanismi di visualizzazione che mostrano lo stato di avanzamento.

Il metodo IWMDMProgress3::Begin3 fornisce ulteriori informazioni sull'azione in corso.

Esempio

Il codice C++ seguente è un'implementazione del metodo Begin .


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