다음을 통해 공유

PCMSCALLBACKW 콜백 함수(icm.h)

  • 아티클

*PCMSCALLBACKW* (또는 ApplyCallbackFunction)는 SetupColorMatchingW 함수가 표시되는 대화 상자가 실행되는 동안 WCS 구성 데이터를 업데이트하는 콜백 함수입니다. ApplyCallbackFunction 이름은 자리 표시자입니다. 이 콜백 함수의 실제 이름은 ICM을 사용하여 애플리케이션에서 제공합니다.

구문

PCMSCALLBACKW Pcmscallbackw;

BOOL Pcmscallbackw(
  _tagCOLORMATCHSETUPW *unnamedParam1,
  LPARAM unnamedParam2
)
{...}

매개 변수

unnamedParam1

WCS 구성 데이터를 포함하는 COLORMATCHSETUPW 구조체에 대한 포인터입니다.

unnamedParam2

애플리케이션에서 제공하는 값을 포함합니다.

반환 값

이 함수가 성공하면 반환 값은 TRUE입니다.

이 함수가 실패하면 반환 값은 FALSE입니다. 콜백 함수는 SetLastError를 호출하여 확장된 오류 정보를 설정할 수 있습니다.

설명

ApplyCallbackFunction 함수는 색 관리 대화 상자가 표시되는 동안 디바이스에 대한 WCS 구성을 변경하는 데 사용됩니다. Color Management 대화 상자는 SetupColorMatchingW 함수에 의해 표시됩니다.

콜백 함수가 제공되면 대화 상자의 오른쪽 아래에 적용 단추가 표시됩니다. 적용 단추를 선택하면 콜백 함수가 설정 중인 디바이스에 대한 구성을 즉시 업데이트합니다. 색 관리 대화 상자가 화면에 남아 있습니다.

애플리케이션은 SetupColorMatchingW 함수에 전달되는 COLORMATCHSETUPW 구조체에 콜백 함수의 주소를 저장하여 콜백 함수를 WCS에 제공합니다. 주소는 COLORMATCHSETUP 구조체의 lPfnApplyCallback 멤버에 저장됩니다. dwFlags 멤버를 CMS_USEAPPLYCALLBACK 설정하거나 콜백 함수가 무시됩니다.

애플리케이션에서 제공하는 값은 콜백 함수에 전달될 수 있습니다. SetupColorMatchingW 함수를 호출하기 전에 애플리케이션은 COLORMATCHSETUPW 구조체의 lParamApplyCallback 멤버에 값을 저장할 수 있습니다. 콜백 함수가 호출되면 lParamApplyCallback 구조체 멤버의 값이 해당 lParam 매개 변수의 콜백 함수에 전달됩니다.

콜백 함수는 완전히 선택 사항입니다. 제공되지 않으면 색 관리 대화 상자에 적용 단추가 나타나지 않습니다. Microsoft는 애플리케이션이 콜백 함수를 제공하는 것이 좋습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 icm.h

참고 항목