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