На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

DeviceCapabilities



The DeviceCapabilities function retrieves the capabilities of a printer device driver.

DWORD DeviceCapabilities(

LPCTSTR pDevice, // pointer to a printer-name string
LPCTSTR pPort, // pointer to a port-name string
WORD fwCapability, // device capability to query
LPTSTR pOutput, // pointer to the output
CONST DEVMODE *pDevMode // pointer to structure with device data
);


Parameters

pDevice

Pointer to a null-terminated string that contains the name of the printer. Note that this is the name of the printer, not of the printer driver.

pPort

Pointer to a null-terminated string that contains the name of the port to which the device is connected, such as "LPT1".

fwCapability

Specifies the capabilities to query. This parameter can be one of the following values:

Value Meaning
DC_BINADJUST Windows 95 only: Retrieves the page positioning for the paper source specified in the DEVMODE structure pointed to by pdevMode. The return value can be one of the following:
DCBA_FACEUPNONE
DCBA_FACEUPCENTER
DCBA_FACEUPLEFT
DCBA_FACEUPRIGHT
DCBA_FACEDOWNNONE
DCBA_FACEDOWNCENTER
DCBA_FACEDOWNLEFT
DCBA_FACEDOWNRIGHT
DC_BINNAMES Copies an array containing a list of the names of the paper bins. This array is in the form char PaperNames[cBinMax][cchBinName] where cchBinName is 24. If the pOutput parameter is NULL, the return value is the number of bin entries required. Otherwise, the return value is the number of bins copied.
DC_BINS Retrieves a list of available bins. The function copies the list to the pOutput parameter as a WORD array. If pOutput is NULL, the function returns the number of supported bins to allow the application the opportunity to allocate a buffer with the correct size. For more information about these bins, see the description of the dmDefaultSource member of the DEVMODE structure.
DC_COPIES Returns the number of copies the device can print.
DC_DRIVER Returns the version number of the printer driver.
DC_DATATYPE_PRODUCED Windows 95 only: The return value is the number of datatypes supported by the printer driver. If the function returns -1, the driver understands the "RAW" datatype only. The names of the supported datatypes are copied to an array. Use the names in the DOCINFO structure when calling the StartDoc function to specify the datatype.
DC_DUPLEX Returns the level of duplex support. The function returns 1 if the printer is capable of duplex printing. Otherwise, the return value is zero.
DC_EMF_COMPLIANT Windows 95 only: Determines if a printer driver supports enhanced metafile (EMF). A return value of 1 means the driver supports EMF. A return value of -1 means that the driver does not support EMF
DC_ENUMRESOLUTIONS Returns a list of available resolutions. If pOutput is NULL, the function returns the number of available resolution configurations. Resolutions are represented by pairs of LONG integers representing the horizontal and vertical resolutions (specified in dots per inch).
DC_EXTRA Returns the number of bytes required for the device-specific portion of the DEVMODE structure for the printer driver.
DC_FIELDS Returns the dmFields member of the printer driver's DEVMODE structure. The dmFields member indicates which members in the device-independent portion of the structure are supported by the printer driver.
DC_FILEDEPENDENCIES Returns a list of files that also need to be loaded when a driver is installed. If the pOutput parameter is NULL, the function returns the number of files. Otherwise, pOutput points to an array of filenames in the form char[chFileName, 64]. Each filename is a null-terminated string.
DC_MAXEXTENT Returns a POINTS structure that contains the maximum paper size that the dmPaperLength and dmPaperWidth members of the printer driver's DEVMODE structure can specify. The x member of the POINTS structure contains the maximum dmPaperWidth value, and the y member contains the maximum dmPaperLength value.
DC_MINEXTENT Returns a POINTS structure that contains the minimum paper size that the dmPaperLength and dmPaperWidth members of the printer driver's DEVMODE structure can specify. The x member of the POINTS structure contains the minimum dmPaperWidth value, and the y member contains the minimum dmPaperLength value.
DC_ORIENTATION Returns the relationship between portrait and landscape orientations for a device, in terms of the number of degrees that portrait orientation is rotated counterclockwise to produce landscape orientation. The return value can be one of the following:


Value Meaning
0 No landscape orientation.
90 Portrait is rotated 90 degrees to produce landscape. (For example, Hewlett-Packard PCL printers.)
270 Portrait is rotated 270 degrees to produce landscape. (For example, dot-matrix printers.)


DC_PAPERNAMES Retrieves a list of supported paper names (for example, Letter or Legal). If the pOutput parameter is NULL, the function returns the number of paper sizes available. Otherwise, pOutput points to an array for the paper names in the form char[cPaperNames, 64]. Each paper name is a null-terminated string.
DC_PAPERS Retrieves a list of supported paper sizes. The function copies the list to pOutput as a WORD array and returns the number of entries in the array. If pOutput is NULL, the function returns the number of supported paper sizes to allow the application the opportunity to allocate a buffer with the correct size. For more information on paper sizes, see the description of the dmPaperSize member of the DEVMODE structure.
DC_PAPERSIZE Copies the dimensions of all supported paper sizes, in tenths of a millimeter, to an array of POINT structures pointed to by the pOutput parameter. The width (x-dimension) and length (y-dimension) of a paper size are returned as if the paper were in the DMORIENT_PORTRAIT orientation.
DC_SIZE Returns the dmSize member of the printer driver's DEVMODE structure.
DC_TRUETYPE Retrieves the abilities of the driver to use TrueType fonts. For DC_TRUETYPE, the pOutput parameter should be NULL. The return value can be one or more of the following:


Value Meaning
DCTT_BITMAP Device can print TrueType fonts as graphics. (For example, dot-matrix and PCL printers.)
DCTT_DOWNLOAD Device can download TrueType fonts. (For example, PCL and PostScript printers.)
DCTT_DOWNLOAD_
OUTLINE Windows 95 only: Device can download outline TrueType fonts.
DCTT_SUBDEV Device can substitute device fonts for TrueType fonts. (For example, PostScript printers.)



DC_VERSION Returns the specification version to which the printer driver conforms.


pOutput

Pointer to an array of bytes. The format of the array depends on the setting of the fwCapability parameter. If pOutput is zero, DeviceCapabilities returns the number of bytes required for the output data.

pDevMode

Pointer to a DEVMODE structure. If this parameter is NULL, DeviceCapabilities retrieves the current default initialization values for the specified printer driver. Otherwise, the function retrieves the values contained in the structure to which pDevMode points.



Return Values

If the function succeeds, the return value depends on the setting of the fwCapability parameter.
If the function fails, the return value is -1.

Remarks

In previous versions of Windows, the DeviceCapabilities function was implemented in the printer driver and you needed to call the LoadLibrary and GetProcAddress functions to get a pointer to the function. This is no longer necessary since DeviceCapabilities is part of the Win32 API and you can call it directly. You should not call LoadLibrary on the printer driver.
The DEVMODE structure pointed to by the pDevMode parameter may be obtained by calling the DocumentProperties function.

See Also

DEVMODE, DocumentProperties, GetDeviceCaps, GetProcAddress, LoadLibrary, POINT


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

DeviceCapabilities



Функция DeviceCapabilities извлекает возможности водителя устройства принтера.

DWORD DeviceCapabilities(

LPCTSTR pDevice, // УКАЗАТЕЛЬ в принтер-имя строки LPCTSTR pPort, // указатель в порт-имя ТЕКСТОВОГО fwCapability строки, // возможности устройства на запрос LPTSTR pOutput, // указатель на выход CONST DEVMODE *указатель pDevMode // в структуру с данными устройства
);


Параметры

pDevice

Указатель в недействительный расторгнутую строку, которая содержит имя принтера. Отметьте, что это - имя принтера, не драйвера принтера.

pPort

Указатель в недействительный расторгнутую строку, которая содержит имя порта на который устройство связано, как например, "LPT1".

fwCapability

Определяет возможности на запрос. Этот параметр может быть одним из следующего величин:

Значение Величины
DC_BINADJUST Windows 95 только: Извлекает страницу, позиционирующуюся для бумажного источника определенного в структуре DEVMODE указанного, чтобы pdevMode. Обратная величина может быть одним из следующего:
DCBA_FACEUPNONE DCBA_FACEUPCENTER DCBA_FACEUPLEFT DCBA_FACEUPRIGHT DCBA_FACEDOWNNONE DCBA_FACEDOWNCENTER DCBA_FACEDOWNLEFT DCBA_FACEDOWNRIGHT
DC_BINNAMES Копирует массив, содержащий список имен бумажных бункеров. Этот массив - в символе формы PaperNames[cBinMax][cchBinName] где cchBinName - 24. Если параметр pOutput НЕДЕЙСТВИТЕЛЕН, обратная величина является номером необходимых данных бункера. В противном случае, обратная величина является количеством скопированных бункеров.
DC_BINS Извлекает список доступных бункеров. Функция копирует список в параметр pOutput как ТЕКСТОВЫЙ массив. Если pOutput НЕДЕЙСТВИТЕЛЕН, функция возвращает количество предусмотренных бункеров, чтобы допускать приложению возможность распределять буфер с правильным размером. Более подробно об этих бункерах, смотри описание элемента dmDefaultSource структуры DEVMODE.
DC_COPIES Возвращает количество копий, которые устройство может напечатать.
DC_DRIVER Возвращает номер версии драйвера принтера.
DC_DATATYPE_PRODUCED Windows 95 только: обратная величина является числом datatypes предусмотренным драйвером принтера. Если функция возвращает -1, драйвер понимает "СЫРОЙ" datatype только. Имена предусмотренных datatypes скопированы в массив. Используйте имена в структуре DOCINFO при вызове функции StartDoc, чтобы определять datatype.
DC_DUPLEX Возвращает уровень поддержки дуплекса. Функция возвращает 1 если принтер способный дуплексной печати. В противном случае, обратная величина нулевая.
DC_EMF_COMPLIANT Windows 95 только: Определяется если драйвер принтера поддерживает расширенный метафайл (EMF). Обратная величина 1 означает драйверные опоры EMF. Обратная величина -1 означает, что драйвер не поддерживает EMF DC_ENUMRESOLUTIONS Возвращает список доступных разрешения. Если pOutput НЕДЕЙСТВИТЕЛЕН, функция возвращает номер доступных конфигураций разрешения. Разрешение представлены парами ДЛИННЫХ целых, представляющих горизонтальное и вертикальное разрешение (определенное в точках за дюйм).
DC_EXTRA Возвращает количество байтов необходимое для зависящей от устройства части структуры DEVMODE для драйвера принтера.
DC_FIELDS Возвращает элемент dmFields принтера драйверной структуры DEVMODE. Элемент dmFields указывает каких участников в машинонезависимой части структуры поддерживаны драйвером принтера.
DC_FILEDEPENDENCIES Возвращает список файлов, что также должно быть загружено когда драйвер установлен. Если параметр pOutput НЕДЕЙСТВИТЕЛЕН, функция возвращает количество файлов. В противном случае, точки pOutput на массив filenames в символе формы[chFileName, 64]. Каждый filename - недействительный расторгнутая строка.
DC_MAXEXTENT Возвращает структуру ТОЧЕК, которая содержит максимальный бумажный размер, что dmPaperLength и участники dmPaperWidth принтера драйверной структуры DEVMODE могут определиться. x Элемент структуры ТОЧЕК содержит максимальную величину dmPaperWidth, и y элемент содержит максимальную величину dmPaperLength.
DC_MINEXTENT Возвращает структуру ТОЧЕК, которая содержит минимальный бумажный размер, что dmPaperLength и участники dmPaperWidth принтера драйверной структуры DEVMODE могут определиться. x Элемент структуры ТОЧЕК содержит минимальную величину dmPaperWidth, и y элемент содержит минимальную величину dmPaperLength.
DC_ORIENTATION Возвращает отношение между портретной и горизональной ориентацией для устройства, с точки зрения количества градусов, что портретная ориентация вращается против часовой стрелки, чтобы производить горизональную ориентацию. Обратная величина может быть одним из следующего:


Оцените No горизональному Значению ориентации 0.
90 Портретов вращаны 90 градусов, чтобы производить пейзаж. (Например, принтеры Hewlett-Packard PCL.)
270 Портретов вращаны 270 градусов, чтобы производить пейзаж. (Например, точечные-матричные принтеры.)


DC_PAPERNAMES Извлекает список предусмотренных бумажных имен (например, Письмо или Юридическое). Если параметр pOutput НЕДЕЙСТВИТЕЛЕН, функция возвращает количество бумажных размеров доступных. В противном случае, точки pOutput на массив для бумажных имен в символе формы[cPaperNames, 64]. Каждое бумажное имя является недействительный расторгнутой строкой.
DC_PAPERS Извлекает список предусмотренных бумажных размеров. Функция копирует список на pOutput как ТЕКСТОВЫЙ массив и возвращает номер данных в массив. Если pOutput НЕДЕЙСТВИТЕЛЕН, функция возвращает количество предусмотренных бумажных размеров, чтобы допускать приложению возможность распределять буфер с правильным размером. Более подробно в бумажных размерах, смотри описание элемента dmPaperSize структуры DEVMODE.
DC_PAPERSIZE Копирует измерения всех поддерживавшие бумагу измеряет, в десятых миллиметра, в массив структур ТОЧКИ указанной, чтобы параметром pOutput. Ширина (x-dimension) и длина (y-dimension) бумажного размера возвращаны как будто бумага были в ориентации DMORIENT_PORTRAIT.
DC_SIZE Возвращает элемент dmSize принтера драйверной структуры DEVMODE.
DC_TRUETYPE Извлекает способности драйвера, чтобы использовать шрифты TrueType. Для DC_TRUETYPE, параметр pOutput должен быть НЕДЕЙСТВИТЕЛЕН. Обратная величина может быть одно или более из следующего:


Значение Величины
Устройство DCTT_BITMAP может напечатать шрифты TrueType как графику. (Например, точечная-матрица и принтеры PCL.)
Устройство DCTT_DOWNLOAD может загрузить шрифты TrueType. (Например, PCL и принтеры PostScript.)
DCTT_DOWNLOAD_
ОЧЕРТИТЕ Windows 95 только: Устройство может загрузить структурированные шрифты TrueType.
Устройство DCTT_SUBDEV может заменить шрифты устройства для шрифтов TrueType. (Например, принтеры PostScript.)



DC_VERSION Возвращает версию спецификации на которой драйвер принтера соответствует.


pOutput

Указатель в массив байтов. Формат массива зависит от установки параметра fwCapability. Если pOutput - нуль, DeviceCapabilities возвращает количество байтов необходимое для выходных данных.

pDevMode

Указатель в структуру DEVMODE. Если этот параметр НЕДЕЙСТВИТЕЛЕН, DeviceCapabilities извлекает текущие по умолчанию величины инициализации для определенного драйвера принтера. В противном случае, функция извлекает величины содержимые в структуре на которую точки pDevMode.



Обратные Величины

Если функция добивается успеха, обратная величина зависит от установки параметра fwCapability.
Если функция терпит неудачу, обратная величина - -1.

Замечания

В предшествующих версиях Windows, функция DeviceCapabilities была осуществлена на драйвере принтера и Вам нужно называть LoadLibrary и функции GetProcAddress, чтобы получать указатель в функцию. Это больше необходимо с тех пор как DeviceCapabilities - часть Win32 API и Вы можете назвать это непосредственно. Вам не следует назвать LoadLibrary на драйвере принтера.
Структура DEVMODE указанная, чтобы параметром pDevMode может быть получена вызовом функции DocumentProperties.

Смотри Также

DEVMODE, DocumentProperties, GetDeviceCaps, GetProcAddress, LoadLibrary, POINT


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz