Compartir a través de


Función SetThreadIdealProcessorEx (processthreadsapi.h)

Establece el procesador ideal para el subproceso especificado y, opcionalmente, recupera el procesador ideal anterior.

Sintaxis

BOOL SetThreadIdealProcessorEx(
  [in]            HANDLE            hThread,
  [in]            PPROCESSOR_NUMBER lpIdealProcessor,
  [out, optional] PPROCESSOR_NUMBER lpPreviousIdealProcessor
);

Parámetros

[in] hThread

Identificador del subproceso para el que se va a establecer el procesador ideal. Este identificador debe haberse creado con el derecho de acceso THREAD_SET_INFORMATION. Para obtener más información, consulte Derechos de acceso y seguridad de subprocesos.

[in] lpIdealProcessor

Puntero a una estructura PROCESSOR_NUMBER que especifica el número de procesador del procesador ideal deseado.

[out, optional] lpPreviousIdealProcessor

Puntero a una estructura PROCESSOR_NUMBER para recibir el procesador ideal anterior. Este parámetro puede apuntar a la misma ubicación de memoria que el parámetro lpIdealProcessor . Este parámetro puede ser NULL si no se requiere el procesador ideal anterior.

Valor devuelto

Si la función se realiza correctamente, devuelve un valor distinto de cero.

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

Comentarios

Especificar un procesador ideal para subprocesos proporciona una sugerencia al programador sobre el procesador preferido para un subproceso. El programador ejecuta el subproceso en el procesador ideal del subproceso cuando sea posible.

A partir de Windows 11 y Windows Server 2022, en un sistema con más de 64 procesadores, las afinidades de procesos y subprocesos abarcan todos los procesadores del sistema, en todos los grupos de procesadores, de forma predeterminada. SetThreadIdealProcessorEx, al establecer el procesador preferido, también establece el grupo principal del subproceso en el grupo del procesador preferido.

Para compilar una aplicación que usa esta función, establezca _WIN32_WINNT >= 0x0601. Para obtener más información, vea Usar los encabezados de Windows.

Windows Phone 8.1: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8.1 y versiones posteriores.

Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado processthreadsapi.h (incluya Windows.h)
Library Kernel32.lib; WindowsPhoneCore.lib en Windows Phone 8.1
Archivo DLL Kernel32.dll; KernelBase.dll en Windows Phone 8.1

Consulte también

GetThreadIdealProcessorEx

SetThreadIdealProcessor