ID2D1Factory1::RegisterEffectFromString 메서드(d2d1_1.h)
문자열로 지정된 속성 XML을 사용하여 팩터리 instance 내에 효과를 등록합니다.
구문
HRESULT RegisterEffectFromString(
[in] REFCLSID classId,
[in] PCWSTR propertyXml,
[in, optional] const D2D1_PROPERTY_BINDING *bindings,
UINT32 bindingsCount,
const PD2D1_EFFECT_FACTORY effectFactory
);
매개 변수
[in] classId
형식: REFCLSID
등록할 효과의 식별자입니다.
[in] propertyXml
형식: PCWSTR
효과 속성, 형식 및 메타데이터 목록입니다.
[in, optional] bindings
형식: const D2D1_PROPERTY_BINDING*
속성 및 메서드의 배열입니다.
이렇게 하면 속성을 처리할 효과 작성자가 구현한 특정 메서드에 이름으로 속성을 바인딩합니다. 이름은 해당 propertyXml에 있어야 합니다.
bindingsCount
형식: UINT32
바인딩 배열의 바인딩 수입니다.
effectFactory
해당 효과를 만드는 데 사용되는 정적 팩터리입니다.
반환 값
형식: HRESULT
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| HRESULT | 설명 |
|---|---|
| S_OK | 오류가 발생하지 않았습니다. |
| E_OUTOFMEMORY | Direct2D가 호출을 완료하기에 충분한 메모리를 할당할 수 없습니다. |
| E_INVALIDARG | 반환 함수에 잘못된 매개 변수가 전달되었습니다. |
설명
Direct2D 효과는 등록 XML을 통해 등록 시 해당 속성을 정의해야 합니다. 효과는 몇 가지 필수 시스템 속성을 선언하고 사용자 지정 속성을 선언할 수도 있습니다. propertyXml 매개 변수의 서식 지정에 대한 자세한 내용은 사용자 지정 효과를 참조하세요.
RegisterEffect 는 원자성 및 참조가 모두 계산됩니다. 효과 등록을 취소하려면 효과의 classId를 사용하여 UnregisterEffect를 호출합니다.
중요RegisterEffect 는 효과가 포함된 DLL 또는 실행 파일에 대한 참조를 보유하지 않습니다. 애플리케이션은 DLL 또는 실행 파일의 수명이 등록되고 생성된 각 효과의 모든 인스턴스를 완전히 포함하는지 독립적으로 확인해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 8 및 Windows 7용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2012 및 Windows Server 2008 R2용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | d2d1_1.h |
| 라이브러리 | D2d1.lib |
| DLL | D2d1.dll |