Metodo IWICBitmapCodecProgressNotification::RegisterProgressNotification (wincodec.h)

  • Articolo

Registra una funzione di callback di notifica dello stato.

Sintassi

HRESULT RegisterProgressNotification(
  [in] PFNProgressNotification pfnProgressNotification,
  [in] LPVOID                  pvData,
  [in] DWORD                   dwProgressFlags
);

Parametri

[in] pfnProgressNotification

Tipo: PFNProgressNotification

Puntatore di funzione alla funzione di callback di notifica dello stato definita dall'applicazione. Per la firma di callback, vedere ProgressNotificationCallback .

[in] pvData

Tipo: LPVOID

Puntatore ai dati dei componenti per il metodo di callback.

[in] dwProgressFlags

Tipo: DWORD

Flag WICProgressOperation e WICProgressNotification da usare per la notifica di stato.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Le applicazioni possono registrare un solo callback. Le chiamate di registrazione successive sostituiranno il callback registrato in precedenza. Per annullare la registrazione di un callback, passare NULL o registrare una nuova funzione di callback.

Lo stato di avanzamento viene segnalato in ordine crescente compreso tra 0,0 e 1,0. Se dwProgressFlags include WICProgressNotificationBegin, il callback viene chiamato con stato 0.0. Se dwProgressFlags include WICProgressNotificationEnd, il callback viene chiamato con stato 1.0.

WICProgressNotificationFrequent aumenta la frequenza in cui viene chiamato il callback. Se un'operazione richiede più di 30 secondi, WICProgressNotificationFrequent deve essere aggiunto a dwProgressFlags.

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP2, Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione wincodec.h
Libreria Windowscodecs.lib

Vedi anche

IWICBitmapCodecProgressNotification

ProgressNotificationCallback