ID2D1Factory1::GetEffectProperties 메서드(d2d1_1.h)
효과의 속성을 검색합니다.
구문
HRESULT GetEffectProperties(
[in] REFCLSID effectId,
[out] ID2D1Properties **properties
);
매개 변수
[in] effectId
형식: REFCLSID
속성을 검색할 효과의 ID입니다.
[out] properties
형식: ID2D1속성**
이 메서드가 반환될 때 효과의 메타데이터를 쿼리하는 데 사용할 수 있는 속성 인터페이스에 대한 포인터의 주소를 포함합니다.
반환 값
형식: HRESULT
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| HRESULT | 설명 |
|---|---|
| S_OK | 오류가 발생하지 않았습니다. |
| D2DERR_EFFECT_IS_NOT_REGISTERED | 요청한 효과를 찾을 수 없습니다. |
| E_OUTOFMEMORY | Direct2D가 호출을 완료하기에 충분한 메모리를 할당할 수 없습니다. |
설명
반환된 효과 속성에는 효과에 대한 모든 변경 가능한 속성이 기본값인 NULL 또는 빈 값으로 설정됩니다.
- 값 형식은 0으로 채워집니다.
- Blob 및 문자열 형식은 길이가 0입니다.
- 배열 형식의 길이는 1이고 배열의 요소는 이전 규칙을 준수합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | d2d1_1.h |
| 라이브러리 | D2d1.lib |
| DLL | D2d1.dll |