Compartir a través de

Función EnumColorProfilesW (icm.h)

  • Artículo

Enumera todos los perfiles que cumplen los criterios de enumeración especificados.

Sintaxis

BOOL EnumColorProfilesW(
  PCWSTR     pMachineName,
  PENUMTYPEW pEnumRecord,
  PBYTE      pEnumerationBuffer,
  PDWORD     pdwSizeOfEnumerationBuffer,
  PDWORD     pnProfiles
);

Parámetros

pMachineName

Reservado. Debe ser NULL. Este parámetro está pensado para apuntar al nombre del equipo en el que se van a enumerar los perfiles. Un puntero NULL indica el equipo local.

pEnumRecord

Puntero a una estructura que especifica los criterios de enumeración.

pEnumerationBuffer

Puntero a un búfer en el que se van a enumerar los perfiles. Una MULTI_SZ cadena de nombres de perfil que satisfaga los criterios especificados en *pEnumRecord se colocará en este búfer.

pdwSizeOfEnumerationBuffer

Puntero a una variable que contiene el tamaño del búfer al que apunta pBuffer. En la devolución, *pdwSize contiene el tamaño del búfer realmente usado o necesario.

pnProfiles

Puntero a una variable que contendrá, a cambio, el número de nombres de perfil copiados realmente en el búfer.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en esta función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Normalmente, varios perfiles están asociados a impresoras, basadas en los tipos de papel y tinta. Hay un perfil predeterminado para cada dispositivo. En el caso de los perfiles de International Color Consortium (ICC), GDI selecciona el mejor de los perfiles asociados a icc cuando la aplicación crea un contexto de dispositivo (DC).

No intente usar EnumColorProfiles para determinar el perfil predeterminado de un dispositivo. En su lugar, cree un contexto de dispositivo para el dispositivo y, a continuación, invoque la función GetICMProfile . En Windows Vista y Windows 7, la función WcsGetDefaultColorProfile también se puede usar para determinar el perfil de color predeterminado de un dispositivo.

Si el miembro dwFields de la estructura de tipo ENUMTYPE al que apunta el parámetro pEnumRecord se establece en ET_DEVICENAME, esta función enumerará todos los perfiles de color asociados a todos los tipos de dispositivos conectados al equipo del usuario, independientemente de la clase de dispositivo. Si el miembro dwFields de la estructura a la que apunta el parámetro pEnumRecord se establece en ET_DEVICENAME o ET_DEVICECLASS y se especifica una clase de dispositivo en el miembro dwDeviceClass de la estructura, esta función solo enumerará los perfiles asociados a la clase de dispositivo especificada. Si el miembro dwFields solo se establece en ET_DEVICECLASS, la función EnumColorProfiles enumerará todos los perfiles que se pueden asociar a ese tipo de dispositivo.

Cada vez que EnumColorProfiles examina los perfiles asociados a un dispositivo específico, los resultados dependen de si el usuario ha elegido usar la lista de perfiles de todo el sistema asociados a ese dispositivo o su propia lista ("por usuario"). Al llamar a WcsSetUsePerUserProfiles con su parámetro usePerUserProfiles establecido en TRUE , las llamadas futuras a EnumColorProfiles solo examinan la lista de asociaciones de perfil por usuario del usuario actual para el dispositivo especificado. Llamar a WcsSetUsePerUserProfiles con su parámetro usePerUserProfiles establecido en FALSE hace que las llamadas futuras a EnumColorProfiles examinen la lista de asociaciones de perfil para todo el sistema para el dispositivo especificado. Si nunca se ha llamado a WcsSetUsePerUserProfiles para el usuario actual, EnumColorProfiles examina la lista de todo el sistema.

La aplicación puede usar EnumColorProfiles para obtener el tamaño del búfer en el que se enumeran los perfiles. Debe llamar a la función EnumColorProfiles con el parámetro pBuffer establecido en NULL. Cuando se devuelve la función, el parámetro pdwSize contendrá el tamaño de búfer necesario en bytes. El programa puede usar esa información para asignar el búfer de enumeración. A continuación, puede invocar DeumColorProfiles de nuevo con el parámetro pBuffer establecido en la dirección del búfer.

Esta función proporcionará la información para convertir la información de DMP específica de WCS en el registro EnumType heredado en la habilitación de la enumeración de perfiles coherente. Los valores predeterminados serán los mismos que icc si esta información no está presente.

Soporte técnico por usuario o LUA

La enumeración es específica del usuario actual. Se tienen en cuenta las asociaciones de dispositivos de usuario actuales y de todo el sistema. Para la configuración predeterminada del perfil, la configuración de usuario actual invalida las de todo el sistema.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado icm.h

Consulte también