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 함수를 제공할 수 있습니다. 함수가 제공되면 GDI는 ICM이 인쇄 작업에 대해 사용하도록 설정된 경우 함수를 호출합니다. 이 함수의 목적은 인쇄 작업에 사용하기에 적합한 ICC 프로필을 결정하고 지정하는 것입니다.

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

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

요구 사항

요구	값
대상 플랫폼	바탕 화면
헤더	winddiui.h(Winddiui.h 포함)