Функция DrvSplDeviceCaps (winddiui.h)

Статья
02/07/2025

Библиотека 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, представляющую имя для формы бумаги, доступной для использования. Возвращаемое значение функции должно быть числом элементов в возвращаемом массиве. Если pOutputNULL, функция должна только вернуть необходимое количество элементов массива.
DC_PAPERNAMES	Параметр pOutput указывает на буфер, который функция должна заполнить массивом строковых буферов, каждый из 64 символов длиной. Каждый элемент массива должен содержать строку, завершающую значение NULL, представляющую имя для формы бумаги. Возвращаемое значение функции должно быть числом элементов в возвращаемом массиве. Если pOutputNULL, функция должна только вернуть необходимое количество элементов массива.

Флаг

Определение

DC_MEDIAREADY

Параметр pOutput указывает на буфер, который функция должна заполнить массивом строковых буферов, каждый из 64 символов длиной. Каждый элемент массива должен содержать строку, завершающую значение NULL, представляющую имя для формы бумаги, доступной для использования. Возвращаемое значение функции должно быть числом элементов в возвращаемом массиве. Если pOutputNULL, функция должна только вернуть необходимое количество элементов массива.

DC_PAPERNAMES

Параметр pOutput указывает на буфер, который функция должна заполнить массивом строковых буферов, каждый из 64 символов длиной. Каждый элемент массива должен содержать строку, завершающую значение NULL, представляющую имя для формы бумаги. Возвращаемое значение функции должно быть числом элементов в возвращаемом массиве. Если pOutputNULL, функция должна только вернуть необходимое количество элементов массива.

[out, optional] pOutput

Вызывающий указатель на буфер, который получает сведения, предоставленные функцией. Использование буфера зависит от значения параметра Capability. Вызывающий объект отвечает за выделение и освобождение этого буфера.

cchBufSize

Указанный вызывающим объектом размер (в символах) буфера, на который указывает параметр pOutput.

[in, optional] pDevmode

Вызывающий указатель на структуру DEVMODEW, описывающую текущие характеристики задания печати. Если null, функция должна использовать внутреннюю структуру DEVMODEW драйвера по умолчанию.

Возвращаемое значение

Возвращаемое значение зависит от параметра Возможности. Если возможности указывает на возможность, которую драйвер не поддерживает, или если возникла ошибка, функция должна вернуть GDI_ERROR.

Замечания

Описание флагов DC_XXX см. в разделе DrvDeviceCapabilities.

Эта функция должна быть определена в файле DEF как DrvSplDeviceCaps @ 254, так как spooler использует порядковый номер 254 для получения указателя функции драйвера.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	winddiui.h (include Winddiui.h)

См. также

DrvDeviceCapabilities

Поделиться через