IPrintOemUI::QueryColorProfile 메서드(prcomoem.h)

메서드 IPrintOemUI::QueryColorProfile 를 사용하면 사용자 인터페이스 플러그 인이 색 관리에 사용할 ICC 프로필을 지정할 수 있습니다.

구문

HRESULT QueryColorProfile(
  HANDLE    hPrinter,
  POEMUIOBJ poemuiobj,
  PDEVMODE  pPublicDM,
  PVOID     pOEMDM,
  ULONG     ulQueryMode,
  VOID      *pvProfileData,
  ULONG     *pcbProfileData,
  FLONG     *pflProfileData
);

매개 변수

hPrinter

발신자가 제공한 프린터 핸들입니다.

poemuiobj

OEMUIOBJ 구조체에 대한 호출자 제공 포인터입니다.

pPublicDM

유효성이 검사된 DEVMODEW 구조체에 대한 호출자 제공 포인터입니다.

pOEMDM

사용자 인터페이스 플러그 인의 프라이빗 DEVMODEW 구조체 멤버에 대한 호출자 제공 포인터입니다.

ulQueryMode

지정할 프로필의 유형을 나타내는 다음 호출자 제공 비트 플래그 중 하나입니다.

플래그	정의
QCP_DEVICEPROFILE	호출자가 디바이스 프로필을 요청하고 있습니다.
QCP_SOURCEPROFILE	호출자가 원본 프로필을 요청하고 있습니다.

pvProfileData

프로필 정보를 수신하기 위한 버퍼에 대한 호출자 제공 포인터입니다.

pcbProfileData

pvProfileData가 가리키는 버퍼의 크기(바이트)를 나타내는 값에 대한 호출자 제공 포인터입니다.

pflProfileData

메서드가 반환하는 정보의 형식을 나타내는 다음 메서드 제공 비트 플래그 중 하나입니다.

플래그	정의
QCP_PROFILEDISK	메서드는 pvProfileData가 가리키는 버퍼에서 ICC 프로필의 파일 이름을 반환합니다.
QCP_PROFILEMEMORY	메서드는 pvProfileData가 가리키는 버퍼의 프로필 데이터를 반환합니다.

반환 값

메서드는 다음 값 중 하나를 반환해야 합니다.

반환 코드	Description
S_OK	작업에 성공했습니다.
E_FAIL	작업이 실패했습니다.
E_NOTIMPL	메서드가 구현되지 않았습니다.

설명

사용자 인터페이스 플러그 인의 IPrintOemUI::QueryColorProfile 메서드는 사용자 모드 프린터 인터페이스 DLL로 내 보낸 DrvQueryColorProfile 함수와 동일한 유형의 작업을 수행합니다. 프린터 이벤트 및 처리 방법에 대한 자세한 내용은 DrvQueryColorProfile 함수에 대한 설명을 참조하세요.

사용자 인터페이스 플러그 인을 제공하는 경우 프린터 드라이버의 DrvQueryColorProfile 함수는 메서드를 호출합니다 IPrintOemUI::QueryColorProfile . DrvQueryColorProfile 함수는 지정된 이벤트에 대해 자체 처리를 수행한 다음 메서드를 IPrintOemUI::QueryColorProfile 호출하여 이벤트의 추가 처리를 처리합니다.

여러 사용자 인터페이스 플러그 인에서 메서드를 내보낼 경우 IPrintOemUI::QueryColorProfile 플러그 인이 설치를 위해 지정된 순서대로 메서드가 호출됩니다.

사용자 인터페이스 플러그 인을 만들고 설치하는 방법에 대한 자세한 내용은 Microsoft의 프린터 드라이버 사용자 지정을 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	prcomoem.h(Prcomoem.h 포함)