Compartir a través de


Función QueryIdleProcessorCycleTimeEx (realtimeapiset.h)

Recupera el tiempo de ciclo acumulado para el subproceso inactivo en cada procesador lógico del grupo de procesadores especificado.

Sintaxis

BOOL QueryIdleProcessorCycleTimeEx(
  [in]      USHORT   Group,
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

Parámetros

[in] Group

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

[in, out] BufferLength

En la entrada, especifica el tamaño del búfer de ProcessorIdleCycleTime, en bytes. Se espera que este búfer sea 8 veces el número de procesadores del grupo.

En la salida, especifica el número de elementos escritos en el búfer. Si el tamaño del búfer no es suficiente, se produce un error en la función y este parámetro recibe la longitud necesaria del búfer.

[out] ProcessorIdleCycleTime

Número de ciclos de reloj de CPU usados por cada subproceso inactivo. Si este parámetro es NULL, la función actualiza el parámetro BufferLength con la longitud necesaria.

Valor devuelto

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

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, use GetLastError.

Observaciones

Para compilar una aplicación que use esta función, establezca _WIN32_WINNT >= 0x0601. Para obtener más información, vea Using the Windows Headers.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 7 [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 R2 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de realtimeapiset.h (incluya Windows.h)
biblioteca de Mincore.lib
DLL de Kernel32.dll

Consulte también

grupos de procesadores de

queryIdleProcessorCycleTime