DrvDeviceCapabilities 함수(winddiui.h)

  • 아티클

프린터 인터페이스 DLL의 DrvDeviceCapabilities 함수는 프린터 기능에 대한 요청된 정보를 반환합니다.

구문

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

매개 변수

hPrinter

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

[in] pszDeviceName

프린터 이름 문자열에 대한 호출자 제공 포인터입니다.

Capability

요청되는 정보를 나타내는 호출자 제공 비트 플래그입니다. 다음 표에 나열된 플래그 중 하나일 수 있습니다. 플래그는 헤더 파일 Wingdi.h에 정의되어 있습니다.

플래그 정의
DC_BINADJUST NT 기반 운영 체제에는 사용되지 않습니다.
DC_BINNAMES pOutput 매개 변수는 함수가 각 24자 길이의 문자열 버퍼 배열로 채워야 하는 버퍼를 가리킵니다. 배열의 각 문자열 버퍼에는 용지 원본 bin의 이름을 지정하는 와이드 문자 NULL로 끝나는 문자열이 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_BINS pOutput 매개 변수는 함수가 WORD 배열로 채워야 하는 버퍼를 가리킵니다. 각 배열 요소에는 지원되는 용지 원본 bin을 나타내는 DMBIN 접두사 상수(또는 사용자 지정된 값)가 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_COLLATE pOutput 매개 변수는 사용되지 않습니다. 프린터에서 정렬을 지원하는 경우 함수의 반환 값은 1이어야 합니다. 그렇지 않으면 반환 값이 0이어야 합니다.
DC_COLORDEVICE pOutput 매개 변수는 사용되지 않습니다. 프린터에서 컬러 인쇄를 지원하는 경우 함수의 반환 값은 1이어야 합니다. 그렇지 않으면 반환 값이 0이어야 합니다.
DC_COPIES pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 프린터에서 지원할 수 있는 최대 복사본 수여야 합니다.
DC_DATATYPE_PRODUCED NT 기반 운영 체제에는 사용되지 않습니다.
DC_DRIVER pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 드라이버 내부 [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 구조체의 dmDriverVersion 멤버여야 합니다.
DC_DUPLEX pOutput 매개 변수는 사용되지 않습니다. 프린터에서 이중 인쇄를 지원하는 경우 함수의 반환 값은 1이어야 합니다. 그렇지 않으면 반환 값이 0이어야 합니다.
DC_EMF_COMPLIANT NT 기반 운영 체제에는 사용되지 않습니다.
DC_ENUMRESOLUTIONS pOutput 매개 변수는 함수가 LONG 배열로 채워야 하는 버퍼를 가리킵니다. 프린터에서 지원하는 각 해상도에 대해 함수는 해상도의 두 개의 긴 단어( x 차원에 대해 하나씩, y 차원에 대해 하나씩)를 인치당 점으로 반환해야 합니다. 함수의 반환 값은 지원되는 해상도 수여야 합니다. pOutput이 NULL인 경우 함수는 지원되는 해상도 수를 반환해야 합니다.
DC_EXTRA pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 드라이버 내부 [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 구조체의 dmDriverExtra 멤버여야 합니다.
DC_FIELDS pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 드라이버 내부 [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 구조체의 dmFields 멤버여야 합니다. dmFields 멤버는 DEVMODEW 구조체의 디바이스 독립적 부분에 있는 어떤 멤버가 프린터 드라이버에서 지원되는지 나타냅니다.
DC_FILEDEPENDENCIES pOutput 매개 변수는 함수가 각각 64자 길이의 문자열 버퍼 배열로 채워야 하는 버퍼를 가리킵니다. 배열의 각 문자열 버퍼에는 드라이버와 함께 설치해야 하는 파일의 이름을 지정하는 와이드 문자 NULL로 끝나는 문자열이 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_MANUFACTURER NT 기반 운영 체제에는 사용되지 않습니다.
DC_MAXEXTENT pOutput 매개 변수는 사용되지 않습니다. 함수는 POINTS 구조를 반환해야 합니다(Microsoft Windows SDK 설명서에 설명됨). 구조체에는 프린터 DEVMODEW 구조체의 dmPaperWidth (x 차원) 및 dmPaperLength (y 차원) 멤버에 허용되는 최대 값이 포함되어야 합니다.
DC_MEDIAREADY pOutput 매개 변수는 함수가 각각 64자 길이의 문자열 버퍼 배열로 채워야 하는 버퍼를 가리킵니다. 배열의 각 문자열 버퍼에는 사용할 수 있는 용지 폼의 이름을 지정하는 NULL로 끝나는 와이드 문자열이 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_MEDIATYPENAMES pOutput 매개 변수는 함수가 각각 64자 길이의 문자열 버퍼 배열로 채워야 하는 버퍼를 가리킵니다. 배열의 각 문자열 버퍼에는 지원되는 미디어 형식의 이름을 지정하는 와이드 문자 NULL로 끝나는 문자열이 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_MEDIATYPES pOutput 매개 변수는 함수가 DWORD 배열로 채워야 하는 버퍼를 가리킵니다. 각 배열 요소에는 DMMEDIA 접두사 상수([DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 구조 참조) 또는 지원되는 미디어 형식을 나타내는 사용자 지정된 값이 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_MINEXTENT pOutput 매개 변수는 사용되지 않습니다. 함수는 POINTS 구조체를 반환해야 합니다(Windows SDK 설명서에 설명되어 있습니다). 구조체에는 프린터 DEVMODEW 구조체의 dmPaperWidth (x 차원) 및 dmPaperLength (y 차원) 멤버에 허용되는 최소 값이 포함되어야 합니다.
DC_MODEL NT 기반 운영 체제에는 사용되지 않습니다.
DC_NUP pOutput 매개 변수는 함수가 DWORD 배열로 채워야 하는 버퍼를 가리킵니다. 각 배열 요소에는 N-up 옵션을 나타내는 정수가 포함되어야 합니다(즉, 각 정수는 실제 페이지당 지원되는 문서 페이지 수를 나타내야 함). 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_ORIENTATION pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 세로 방향에서 가로 방향을 생성하는 데 필요한 회전 각도 수여야 합니다. 값이 0이면 가로 방향이 지원되지 않음을 나타냅니다.
DC_PAPERNAMES pOutput 매개 변수는 함수가 각각 64자 길이의 문자열 버퍼 배열로 채워야 하는 버퍼를 가리킵니다. 배열의 각 문자열 버퍼에는 용지 폼의 이름을 지정하는 와이드 문자 NULL로 끝나는 문자열이 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_PAPERS pOutput 매개 변수는 함수가 WORD 배열로 채워야 하는 버퍼를 가리킵니다. 각 배열 요소에는 지원되는 용지 양식을 나타내는 DMPAPER 접두사 상수(또는 사용자 지정된 값)가 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_PAPERSIZE pOutput 매개 변수는 함수가 POINT 배열로 채워야 하는 버퍼를 가리킵니다. 각 배열 요소는 세로 방향으로 0.1mm 단위로 양식의 용지 크기의 x 및 y 차원을 포함해야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_PERSONALITY pOutput 매개 변수는 함수가 각 32자 길이의 문자열 버퍼 배열로 채워야 하는 버퍼를 가리킵니다. 배열의 각 문자열 버퍼에는 프린터에서 지원하는 프린터 설명 언어(예: L"HP-GL/2")를 지정하는 NULL로 끝나는 와이드 문자열이 포함되어야 합니다. 함수의 반환 값은 반환된 배열의 요소 수여야 합니다. pOutput이 NULL인 경우 함수는 필요한 배열 요소 수를 반환해야 합니다.
DC_PRINTERMEM pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 사용 가능한 프린터 메모리 양(킬로바이트)을 나타내는 정수여야 합니다.
DC_PRINTRATE pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 DC_PRINTRATEUNIT 지정된 단위에서 인쇄 속도를 나타내는 정수여야 합니다.
DC_PRINTRATEPPM pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 분당 페이지 단위의 인쇄 속도를 나타내는 정수여야 합니다.
DC_PRINTRATEUNIT pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 DC_PRINTRATE 반환된 값을 지정하는 데 사용되는 단위를 식별해야 합니다. 다음 상수 중 하나를 지정해야 합니다. PRINTRATEUNIT_PPM - pages/min. PRINTRATEUNIT_CPS - chars./sec. PRINTRATEUNIT_LPM - lines/min. PRINTRATEUNIT_IPM - 인치/분.
DC_SIZE pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 드라이버 내부 [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 구조체의 dmSize 멤버여야 합니다.
DC_STAPLE pOutput 매개 변수는 사용되지 않습니다. 프린터에서 스테이플링을 지원하는 경우 함수의 반환 값은 TRUE 이고 프린터에서 스테이플링을 지원하지 않는 경우 FALSE 여야 합니다.
DC_TRUETYPE pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 다음 플래그 중 0개 이상일 수 있습니다. DCTT_BITMAP: 디바이스는 TrueType 글꼴을 그래픽으로 인쇄할 수 있습니다. DCTT_DOWNLOAD: 디바이스에서 다운로드한 TrueType 글꼴을 수락할 수 있습니다. DCTT_DOWNLOAD_OUTLINE: (Windows 95/98/나만 해당) 디바이스는 개요 TrueType 글꼴을 다운로드할 수 있습니다. DCTT_SUBDEV: 디바이스는 디바이스 글꼴을 TrueType 글꼴로 대체할 수 있습니다.
DC_VERSION pOutput 매개 변수는 사용되지 않습니다. 함수의 반환 값은 드라이버 내부 [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 구조체의 dmSpecVersion 멤버여야 합니다.

[out] pOutput

함수 제공 정보를 수신하기 위한 버퍼에 대한 호출자 제공 포인터입니다. 버퍼의 사용은 Capability 매개 변수에 대해 받은 값에 따라 달라집니다.

[in, optional] pDevmode

현재 인쇄 작업 특성을 설명하는 DEVMODEW 구조체에 대한 호출자 제공 포인터입니다. 이 매개 변수가 NULL인 경우 DrvDeviceCapabilities 는 인쇄 큐의 사용자 기본 DEVMODEW 구조와 같이 지정된 프린터 드라이버의 현재 기본 초기화 값을 검색합니다.

반환 값

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

요구 사항

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