DrvSplDeviceCaps function

A printer interface DLL's DrvSplDeviceCaps function queries a printer for its capabilities.

Syntax

DWORD DrvSplDeviceCaps(
            HANDLE   hPrinter,
  _In_      PWSTR    pwDeviceName,
            WORD     DeviceCap,
  _Out_opt_ PVOID    pvOutput,
            DWORD    cchBuf,
  _In_opt_  PDEVMODE pDM
);

Parameters

hPrinter

Caller-supplied handle to the printer.

pszDeviceName

Capability

pOutput

cchBufSize

pDevmode

Return Value

The return value depends on the DeviceCap parameter. If DeviceCap indicates a capability that the driver does not support, or if an error is encountered, the function should return GDI_ERROR.

Remarks

The DrvSplDeviceCaps function is available in Microsoft Windows Server 2003 and later.

For descriptions of the DC_XXX flags, see DrvDeviceCapabilities.

This function must be defined in the .def file as DrvSplDeviceCaps @ 254, because the spooler uses the ordinal number 254 to obtain the driver function pointer.

Requirements

   
Windows Driver kit version
Target platform Desktop
Minimum KMDF version
Minimum UMDF version
Header winddiui.h (include Winddiui.h)
Library
IRQL
DDI compliance rules

See Also

DrvDeviceCapabilities

Send comments about this topic to Microsoft