ID2D1DeviceContext::CreateEffect 메서드(d2d1_1.h)
지정된 클래스 ID에 대한 효과를 만듭니다.
구문
HRESULT CreateEffect(
REFCLSID effectId,
[out] ID2D1Effect **effect
);
매개 변수
effectId
형식: REFCLSID
만들 효과의 클래스 ID입니다. 효과 ID 목록은 기본 제공 효과를 참조하세요.
[out] effect
형식: ID2D1Effect**
이 메서드가 반환되면 새 효과에 대한 포인터의 주소가 포함됩니다.
반환 값
형식: 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 |