DrvQueryColorProfile 함수(winddiui.h)

DrvQueryColorProfile 함수를 사용하면 프린터 인터페이스 DLL이 색 관리에 사용할 ICC 프로필을 지정할 수 있습니다.

구문

BOOL DrvQueryColorProfile(
        HANDLE    hPrinter,
  [in]  PDEVMODEW pdevmode,
        ULONG     ulQueryMode,
  [out] VOID      *pvProfileData,
  [out] ULONG     *pcbProfileData,
  [out] FLONG     *pflProfileData
);

매개 변수

hPrinter

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

[in] pdevmode

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

ulQueryMode

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

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

[out] pvProfileData

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

[out] pcbProfileData

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

[out] pflProfileData

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

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

반환 값

작업이 성공하면 함수는 TRUE를 반환합니다. 그렇지 않으면 FALSE를 반환 합니다.

설명

프린터 인터페이스 DLL은 필요에 따라 DrvQueryColorProfile 함수를 제공할 수 있습니다. 함수가 제공되면 인쇄 작업에 대해 ICM이 사용하도록 설정된 경우 GDI는 함수를 호출합니다. 함수의 목적은 인쇄 작업에 사용하기에 적합한 ICC 프로필을 결정하고 지정하는 것입니다.

드라이버의 프린터 인터페이스 DLL이 DrvQueryColorProfile 함수를 제공하지 않거나 함수가 FALSE를 반환하는 경우 GDI는 프로필을 찾으려고 시도합니다. 자세한 내용은 ICC 프로필 찾기를 참조하세요.

pcbProfileData로 지정된 출력 버퍼 크기가 너무 작으면 드라이버는 pcbProfileData에서 제공하는 크기 값을 필요한 버퍼 크기로 덮어쓰고 SetLastError(ERROR_INSUFFICIENT_BUFFER)를 호출하고 FALSE를 반환해야 합니다.

요구 사항

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