Función DrvSplDeviceCaps (winddiui.h)
Una función DrvSplDeviceCaps de la interfaz de impresora consulta una impresora para sus funcionalidades.
Sintaxis
DWORD DrvSplDeviceCaps(
HANDLE hPrinter,
[in] PWSTR pszDeviceName,
WORD Capability,
[out, optional] PVOID pOutput,
DWORD cchBufSize,
[in, optional] PDEVMODE pDevmode
);
Parámetros
hPrinter
Controlador proporcionado por el autor de la llamada a la impresora.
[in] pszDeviceName
Puntero proporcionado por el autor de la llamada a una cadena Unicode que contiene el nombre de la impresora.
Capability
Marca de bits proporcionada por el autor de la llamada que indica la capacidad de consultar. (Las marcas se definen en el archivo de encabezado wingdi.h).) Esta función no es necesaria para admitir todas las marcas DC_XXX , pero debe admitir las enumeradas en la tabla siguiente.
| Marca | Definición |
|---|---|
| DC_MEDIAREADY | El parámetro pOutput apunta a un búfer que la función debe rellenar con una matriz de búferes de cadena, cada 64 caracteres de longitud. Cada elemento de matriz debe contener una cadena terminada en NULL que represente un nombre para un formulario de papel que esté disponible para su uso. El valor devuelto de la función debe ser el número de elementos de la matriz devuelta. Si pOutput es NULL, la función solo debe devolver el número de elementos de matriz necesarios. |
| DC_PAPERNAMES | El parámetro pOutput apunta a un búfer que la función debe rellenar con una matriz de búferes de cadena, cada 64 caracteres de longitud. Cada elemento de matriz debe contener una cadena terminada en NULL que represente un nombre para un formulario de papel. El valor devuelto de la función debe ser el número de elementos de la matriz devuelta. Si pOutput es NULL, la función solo debe devolver el número de elementos de matriz necesarios. |
[out, optional] pOutput
Puntero proporcionado por el autor de la llamada a un búfer que recibe información proporcionada por la función. El uso del búfer depende del valor del parámetro Capability . El autor de la llamada es responsable de asignar y liberar este búfer.
cchBufSize
Tamaño proporcionado por el autor de la llamada (en caracteres) del búfer al que apunta el parámetro pOutput .
[in, optional] pDevmode
Puntero proporcionado por el autor de la llamada a una estructura DEVMODEW que describe las características actuales del trabajo de impresión. Si es NULL, la función debe usar la estructura DEVMODEW predeterminada interna del controlador.
Valor devuelto
El valor devuelto depende del parámetro Capability . Si La funcionalidad indica una funcionalidad que el controlador no admite o si se encuentra un error, la función debe devolver GDI_ERROR.
Comentarios
Para obtener descripciones de las marcas DC_XXX , consulte DrvDeviceCapabilities.
Esta función debe definirse en el archivo .def como DrvSplDeviceCaps @ 254, ya que el administrador de colas usa el número ordinal 254 para obtener el puntero de función del controlador.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | winddiui.h (incluya Winddiui.h) |