IWICBitmapCodecProgressNotification::RegisterProgressNotification-Methode (wincodec.h)

Registriert eine Statusbenachrichtigungsrückruffunktion.

Syntax

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

Parameter

[in] pfnProgressNotification

Typ: PFNProgressNotification

Ein Funktionszeiger auf die von der Anwendung definierte Statusbenachrichtigungsrückruffunktion. Die Rückrufsignatur finden Sie unter ProgressNotificationCallback .

[in] pvData

Typ: LPVOID

Ein Zeiger auf Komponentendaten für die Rückrufmethode.

[in] dwProgressFlags

Art: DWORD

Die Flags WICProgressOperation und WICProgressNotification , die für die Statusbenachrichtigung verwendet werden sollen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Anwendungen können nur einen einzelnen Rückruf registrieren. Nachfolgende Registrierungsaufrufe ersetzen den zuvor registrierten Rückruf. Um die Registrierung eines Rückrufs aufzuheben, übergeben Sie NULL , oder registrieren Sie eine neue Rückruffunktion.

Der Fortschritt wird in einer steigenden Reihenfolge zwischen 0,0 und 1,0 gemeldet. Wenn dwProgressFlagsWICProgressNotificationBegin enthält, wird der Rückruf garantiert mit Status 0.0 aufgerufen. Wenn dwProgressFlagsWICProgressNotificationEnd enthält, wird der Rückruf garantiert mit Status 1.0 aufgerufen.

WICProgressNotificationFrequent erhöht die Häufigkeit, in der der Rückruf aufgerufen wird. Wenn erwartet wird, dass ein Vorgang länger als 30 Sekunden dauert, sollte WICProgressNotificationFrequent zu dwProgressFlags hinzugefügt werden.

Anforderungen

Weitere Informationen

IWICBitmapCodecProgressNotification

ProgressNotificationCallback