Metodo ID2D1Factory1::GetRegisteredEffects (d2d1_1.h)
Restituisce gli ID classe degli effetti attualmente registrati e degli effetti globali su questa factory.
Sintassi
HRESULT GetRegisteredEffects(
[out] CLSID *effects,
UINT32 effectsCount,
[out] UINT32 *effectsReturned,
[out, optional] UINT32 *effectsRegistered
);
Parametri
[out] effects
Tipo: CLSID*
Quando questo metodo restituisce, contiene una matrice di effetti. NULL se non vengono recuperati effetti.
effectsCount
Tipo: UINT32
Capacità della matrice degli effetti .
[out] effectsReturned
Tipo: UINT32*
Quando questo metodo restituisce, contiene il numero di effetti copiati in effetti.
[out, optional] effectsRegistered
Tipo: UINT32*
Quando questo metodo restituisce, contiene il numero di effetti attualmente registrati nel sistema.
Valore restituito
Tipo: HRESULT
Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| HRESULT | Descrizione |
|---|---|
| S_OK | Non si sono verificati errori. |
| E_OUTOFMEMORY | Direct2D non è riuscito a allocare memoria sufficiente per completare la chiamata. |
| HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | effectsRegistered è maggiore di effectCount. |
Commenti
Il set di ID classe verrà restituito atomicamente dall'API. Il set non verrà interrotto da altri thread che registrano o annullano la registrazione degli effetti.
Se effettiRegistered è maggiore di effectCount, la matrice fornita verrà comunque riempita per la capacità con il set corrente di effetti registrati. Questo metodo restituisce i CLSID per tutti gli effetti globali e tutti gli effetti registrati in questa factory.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 e Aggiornamento della piattaforma per Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | d2d1_1.h |
| Libreria | D2d1.lib |
| DLL | D2d1.dll |