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 포함) |