ID2D1Factory1::GetRegisteredEffects 메서드(d2d1_1.h)

이 팩터리에 대해 현재 등록된 효과 및 전역 효과의 클래스 ID를 반환합니다.

구문

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

매개 변수

[out] effects

형식: CLSID*

이 메서드가 반환되면 효과 배열이 포함됩니다. 효과가 검색되지 않으면 NULL입니다.

effectsCount

형식: UINT32

효과 배열의 용량 입니다 .

[out] effectsReturned

형식: UINT32*

이 메서드가 반환되면 효과에 복사된 효과의 수가 포함 됩니다.

[out, optional] effectsRegistered

형식: UINT32*

이 메서드가 반환될 때 시스템에 현재 등록된 효과 수가 포함됩니다.

반환 값

형식: HRESULT

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

HRESULT	설명
S_OK	오류가 발생하지 않았습니다.
E_OUTOFMEMORY	Direct2D가 호출을 완료하기에 충분한 메모리를 할당할 수 없습니다.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	effectsRegistered 가 effectCount보다 큽니다.

설명

클래스 ID 집합은 API에서 원자성으로 반환됩니다. 다른 스레드가 효과를 등록하거나 등록 취소하면 집합이 중단되지 않습니다.

effectsRegistered가 effectCount보다 크면 제공된 배열이 현재 등록된 효과 집합으로 용량으로 채워집니다. 이 메서드는 이 팩터리에 등록된 모든 전역 효과 및 모든 효과에 대한 CLSID를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	d2d1_1.h
라이브러리	D2d1.lib
DLL	D2d1.dll

추가 정보

ID2D1Factory1

ID2D1Factory1::RegisterEffect