ID2D1DeviceContext::CreateEffect 메서드(d2d1_1.h)

지정된 클래스 ID에 대한 효과를 만듭니다.

구문

HRESULT CreateEffect(
        REFCLSID    effectId,
  [out] ID2D1Effect **effect
);

effectId

형식: REFCLSID

만들 효과의 클래스 ID입니다. 효과 ID 목록은 기본 제공 효과를 참조하세요.

[out] effect

이 메서드가 반환되면 새 효과에 대한 포인터의 주소가 포함됩니다.

형식: HRESULT

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

HRESULT	설명
S_OK	오류가 발생하지 않았습니다.
E_OUTOFMEMORY	Direct2D에서 호출을 완료하는 데 충분한 메모리를 할당할 수 없습니다.
E_INVALIDARG	잘못된 값이 메서드에 전달되었습니다.
D3DERR_OUTOFVIDEOMEMORY	Direct3D에 작업을 수행하기에 충분한 디스플레이 메모리가 없습니다.
D2DERR_EFFECT_IS_NOT_REGISTERED	지정된 효과는 시스템에서 등록되지 않습니다.
E_NOTFOUND	등록되지 않은 효과에 대한 다른 가능한 HRESULT(예: D2DERR_EFFECT_IS_NOT_REGISTERED).
D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES	이 효과에는 D2D 디바이스에서 지원되지 않는 기능이 필요합니다.

만든 효과가 DLL에서 구현되는 사용자 지정 효과인 경우 해당 DLL에 대한 참조 수를 증가하지 않습니다. 해당 효과가 로드되는 동안 애플리케이션이 효과를 삭제하면 결과 동작을 예측할 수 없습니다.


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