Función GetPrintProcessorCapabilities (winsplp.h)

La función GetPrintProcessorCap abilities 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 Atributos de de estructuras de 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 que sea 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 de 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.

Observaciones

Los procesadores de impresión pueden exportar opcionalmente 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 colador llama a la función GetPrintProcessorCap abilities de un procesador de impresión cuando una aplicación llama a GetPrinterData, especificando un nombre de valor con un formato de PrintProcCaps_tipo de datos, donde tipo de datos es el nombre de un tipo de datos de entrada. Antes de llamar a GetPrintProcessorCapabilities, la cola 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 la estructura PRINTPROCESSOR_CAPS_1 o PRINTPROCESSOR_CAPS_2 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 pcbNeededed para devolver el tamaño de búfer necesario, tanto si el búfer real es lo suficientemente grande como para no.

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

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	winsplp.h (incluya Winsplp.h)