다음을 통해 공유

DrvSplDeviceCaps 함수(winddiui.h)

  • 아티클

프린터 인터페이스 DLL의 DrvSplDeviceCaps 함수는 프린터의 기능을 쿼리합니다.

구문

DWORD DrvSplDeviceCaps(
                  HANDLE   hPrinter,
  [in]            PWSTR    pszDeviceName,
                  WORD     Capability,
  [out, optional] PVOID    pOutput,
                  DWORD    cchBufSize,
  [in, optional]  PDEVMODE pDevmode
);

매개 변수

hPrinter

프린터에 대한 호출자 제공 핸들입니다.

[in] pszDeviceName

프린터 이름을 포함하는 유니코드 문자열에 대한 호출자 제공 포인터입니다.

Capability

쿼리할 기능을 나타내는 호출자 제공 비트 플래그입니다. (플래그는 헤더 파일 wingdi.h에 정의되어 있습니다.) 이 함수는 모든 DC_XXX 플래그를 지원할 필요는 없지만 다음 표에 나열된 플래그를 지원해야 합니다.

플래그 정의
DC_MEDIAREADY pOutput 매개 변수는 함수가 각각 64자 길이의 문자열 버퍼 배열로 채워야 하는 버퍼를 가리킵니다. 각 배열 요소에는 사용할 수 있는 용지 양식의 이름을 나타내는 NULL로 끝나는 문자열이 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_PAPERNAMES pOutput 매개 변수는 함수가 각각 64자 길이의 문자열 버퍼 배열로 채워야 하는 버퍼를 가리킵니다. 각 배열 요소에는 용지 양식의 이름을 나타내는 NULL로 끝나는 문자열이 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.

[out, optional] pOutput

함수 제공 정보를 수신하는 버퍼에 대한 호출자 제공 포인터입니다. 버퍼의 사용은 Capability 매개 변수의 값에 따라 달라집니다. 호출자는 이 버퍼를 할당하고 해제해야 합니다.

cchBufSize

pOutput 매개 변수가 가리키는 버퍼의 호출자 제공 크기(문자 단위)입니다.

[in, optional] pDevmode

현재 인쇄 작업 특성을 설명하는 DEVMODEW 구조체에 대한 호출자 제공 포인터입니다. NULL인 경우 함수는 드라이버의 내부 기본 DEVMODEW 구조를 사용해야 합니다.

반환 값

반환 값은 Capability 매개 변수에 따라 달라집니다. Capability가 드라이버가 지원하지 않는 기능을 나타내거나 오류가 발생하면 함수가 GDI_ERROR 반환해야 합니다.

설명

DC_XXX 플래그에 대한 설명은 DrvDeviceCapabilities를 참조하세요.

스풀러는 서수 254를 사용하여 드라이버 함수 포인터를 가져오기 때문에 이 함수는 .def 파일에서 DrvSplDeviceCaps @ 254로 정의되어야 합니다.

요구 사항

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

추가 정보

DrvDeviceCapabilities