Función GetPrintProcessorCapabilities (winsplp.h)

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 las PRINTER_INFO_x (que se describe en la documentación de Microsoft Windows SDK).

[out] pData

Puntero proporcionado por el autor de la llamada a PRINTPROCESSOR_CAPS_1 o PRINTPROCESSOR_CAPS_2 estructura (que se describe en la documentación Windows SDK).

[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), en función de la estructura que sea compatible con el procesador de impresión.

Nota Si el valor es menor que sizeof(PRINTPROCESSOR_CAPS_1), el procesador de impresión winprint suministrará un valor de sizeof(PRINTPROCESSOR_CAPS_2) para sistemas operativos Windows Vista o sizeof(PRINTPROCESSOR_CAPS_1) para versiones anteriores del sistema operativo.

[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, debería devolver un código de error de 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 PRINTPROCESSOR_CAPS_1 o PRINTPROCESSOR_CAPS_2 para cada tipo de datos de entrada que admita el procesador de impresión.

El administrador de trabajos de cola llama a la función GetPrintProcessorCapabilities de un procesador de impresión cuando una aplicación llama a GetPrinterData (que se describe en la documentación del SDK de Windows), 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 colador quita el 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 (definida en la documentación del SDK de Windows) y devolver. El valor de nSize determina si PRINTPROCESSOR_CAPS_1 o PRINTPROCESSOR_CAPS_2 se usarán.

La función siempre debe usar la ubicación a la que apunta pwNeeded para devolver el tamaño de búfer necesario, independientemente de 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 colador para GetPrinterData.

Requisitos

Plataforma de destino	Escritorio
Encabezado	winsplp.h (incluir Winsplp.h)