ID2D1Factory1::GetRegisteredEffects-Methode (d2d1_1.h)

  • Artikel

Gibt die Klassen-IDs der derzeit registrierten Effekte und globalen Effekte für diese Factory zurück.

Syntax

HRESULT GetRegisteredEffects(
  [out]           CLSID  *effects,
                  UINT32 effectsCount,
  [out]           UINT32 *effectsReturned,
  [out, optional] UINT32 *effectsRegistered
);

Parameter

[out] effects

Typ: CLSID*

Wenn diese Methode zurückgibt, enthält ein Array von Effekten. NULL , wenn keine Effekte abgerufen werden.

effectsCount

Typ: UINT32

Die Kapazität des Effektarrays .

[out] effectsReturned

Typ: UINT32*

Wenn diese Methode zurückgibt, enthält die Anzahl der Effekte, die in Effekte kopiert wurden.

[out, optional] effectsRegistered

Typ: UINT32*

Wenn diese Methode zurückgibt, enthält die Anzahl der Effekte, die derzeit im System registriert sind.

Rückgabewert

Typ: HRESULT

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

HRESULT BESCHREIBUNG
S_OK Kein Fehler ist aufgetreten.
E_OUTOFMEMORY Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) effectsRegistered ist größer als effectCount.

Hinweise

Der Satz von Klassen-IDs wird von der API atomar zurückgegeben. Die Gruppe wird nicht durch andere Threads unterbrochen, die Effekte registrieren oder die Registrierung aufheben.

Wenn effectsRegistered größer als effectCount ist, wird das angegebene Array weiterhin bis zur Kapazität mit dem aktuellen Satz registrierter Effekte gefüllt. Diese Methode gibt die CLSIDs für alle globalen Effekte und alle in dieser Factory registrierten Effekte zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1_1.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1Factory1

ID2D1Factory1::RegisterEffect