Función GetProcessorSystemCycleTime (sysinfoapi.h)

Recupera el tiempo de ciclo que cada procesador del grupo de procesadores especificado ha dedicado a ejecutar llamadas a procedimientos diferidos (DPC) e interrumpir las rutinas de servicio (ISR) desde que el procesador se activa.

Sintaxis

BOOL GetProcessorSystemCycleTime(
  [in]      USHORT                                   Group,
  [out]     PSYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION Buffer,
  [in, out] PDWORD                                   ReturnedLength
);

Parámetros

[in] Group

Número del grupo de procesadores para el que se va a recuperar el tiempo del ciclo.

[out] Buffer

Puntero a un búfer para recibir una estructura de SYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION para cada procesador del grupo. En la salida, el miembro DWORD64 CycleTime de esta estructura se establece en el tiempo de ciclo de un procesador.

[in, out] ReturnedLength

Tamaño del búfer, en bytes. Cuando la función devuelve, este parámetro contiene el número de bytes escritos en Buffer. Si el búfer es demasiado pequeño para los datos, se produce un error en la función con ERROR_INSUFFICIENT_BUFFER y establece el parámetro ReturnedLength en el tamaño de búfer necesario.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, use GetLastError.

Si el valor de error es ERROR_INSUFFICIENT_BUFFER, el parámetro ReturnedLength contiene el tamaño de búfer necesario.

Comentarios

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0601 o posterior. Para obtener más información, vea Uso de los encabezados de Windows.

Requisitos

Vea también

Grupos de procesadores