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이고 배열의 요소는 이전 규칙을 준수합니다.
이 메서드는 ID2D1DeviceContext::CreateEffect에 표시되지 않는 효과에 대한 속성을 반환하는 데 사용할 수 없습니다.

요구 사항

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

추가 정보

ID2D1Factory1

ID2D1Factory1::GetRegisteredEffects

ID2D1Factory1::RegisterEffect