Compartir a través de

Función WcsEnumColorProfiles (icm.h)

  • Artículo

Enumera los perfiles de color asociados a cualquier dispositivo, en el ámbito especificado.

Nota:

Esta API no admite perfiles de "color avanzado" para monitores HDR. Use ColorProfileGetDisplayList para administrar perfiles de color avanzados.

Sintaxis

BOOL WcsEnumColorProfiles(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PENUMTYPEW                   pEnumRecord,
  PBYTE                        pBuffer,
  DWORD                        dwSize,
  PDWORD                       pnProfiles
);

Parámetros

scope

Valor de WCS_PROFILE_MANAGEMENT_SCOPE que especifica el ámbito de esta operación de administración de perfiles.

pEnumRecord

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

pBuffer

Puntero a un búfer en el que se van a enumerar los nombres de perfil. La función WcsEnumColorProfiles coloca, en este búfer, una cadena de MULTI_SZ que consta de nombres de perfil que cumplen los criterios especificados en *pEnumRecord.

dwSize

Variable que contiene el tamaño, en bytes, del búfer al que apunta pBuffer. Vea Comentarios.

pnProfiles

Puntero opcional a una variable que recibe el número de nombres de perfil que se copian en el búfer al que apunta pBuffer . Puede ser NULL si esta información no es necesaria.

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

Use la función WcsEnumColorProfilesSize para recuperar el valor del parámetro dwSize , que es el tamaño, en bytes, del búfer al que apunta el parámetro pBuffer .

Si el parámetro profileManagementScope es WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, solo se tienen en cuenta las asociaciones de perfiles en todo el sistema del dispositivo. Si profileManagementScope está WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, solo se tienen en cuenta las asociaciones por usuario para el usuario actual. Si nunca se ha llamado a WcsSetUsePerUserProfiles para este usuario, o si wcsSetUsePerUserProfiles se llamó más recientemente para este usuario con su parámetro usePerUserProfiles establecido en FALSE, WCSEnumColorProfiles devuelve una lista vacía.

Si WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER (la configuración del usuario actual) está presente, invalida el valor predeterminado de todo el sistema para el parámetro profileManagementScope .

Esta función es ejecutable en Least-Privileged contexto de la cuenta de usuario (LUA).

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
Library Mscms.lib
Archivo DLL Mscms.dll

Consulte también