Compartir a través de

Función GetPrintProcessorCapabilities (winsplp.h)

  • Artículo

La función GetPrintProcessorCapabilities de un procesador de impresión devuelve funcionalidades asociadas a un tipo de datos de entrada especificado.

Sintaxis

DWORD GetPrintProcessorCapabilities(
  [in]  LPTSTR  pValueName,
  [in]  DWORD   dwAttributes,
  [out] LPBYTE  pData,
  [in]  DWORD   nSize,
  [out] LPDWORD pcbNeeded
);

Parámetros

[in] pValueName

Puntero proporcionado por el autor de la llamada a una cadena que representa un tipo de datos compatible con el procesador de impresión. El puntero de cadena debe ser de tipo LPWSTR.

[in] dwAttributes

Marcas de atributos proporcionados por el autor de la llamada. Consulte el miembro Attributes de estructuras PRINTER_INFO_x .

[out] pData

Puntero proporcionado por el autor de la llamada a una estructura PRINTPROCESSOR_CAPS_1 o PRINTPROCESSOR_CAPS_2 .

[in] nSize

Valor proporcionado por el autor de la llamada que representa el tamaño del búfer al que apunta pData.

Si el valor es menor que sizeof(PRINTPROCESSOR_CAPS_1), esta función debe proporcionar un valor igual a sizeof(PRINTPROCESSOR_CAPS_1) o sizeof(PRINTPROCESSOR_CAPS_2), dependiendo de la estructura que admita el procesador de impresión.

Si el valor es menor que sizeof(PRINTPROCESSOR_CAPS_1), el procesador de impresión winprint proporcionará un valor sizeof(PRINTPROCESSOR_CAPS_2).

[out] pcbNeeded

Puntero proporcionado por el autor de la llamada a una ubicación para recibir el tamaño mínimo necesario para el búfer al que apunta pData.

Valor devuelto

Si la operación se realiza correctamente, la función debe devolver ERROR_SUCCESS. De lo contrario, debe devolver un código de error win32.

Comentarios

Opcionalmente, los procesadores de impresión pueden exportar una función GetPrintProcessorCapabilities . El propósito de la función es devolver una estructura de PRINTPROCESSOR_CAPS_1 rellenada o PRINTPROCESSOR_CAPS_2 para cada tipo de datos de entrada que admita el procesador de impresión.

El administrador de trabajos llama a la función GetPrintProcessorCapabilities de un procesador de impresión cuando una aplicación llama a GetPrinterData, especificando un nombre de valor con un formato de PrintProcCaps_datatype, donde datatype es el nombre de un tipo de datos de entrada. Antes de llamar a GetPrintProcessorCapabilities, el administrador de trabajos quita el prefijo PrintProcCaps_ de la cadena de nombre de valor.

La función debe determinar si el búfer recibido es lo suficientemente grande y, si es así, debe rellenar el PRINTPROCESSOR_CAPS_1 o PRINTPROCESSOR_CAPS_2 estructura y devolver. El valor de nSize determina si se usará PRINTPROCESSOR_CAPS_1 o PRINTPROCESSOR_CAPS_2 .

La función siempre debe usar la ubicación a la que apunta pcbNeeded para devolver el tamaño de búfer necesario, independientemente de que el búfer real sea lo suficientemente grande como para hacerlo.

El valor devuelto especificado se convierte en el valor devuelto que proporciona el administrador de colas para GetPrinterData.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado winsplp.h (incluya Winsplp.h)