CCHAR
KeSetIdealProcessorThread(
  IN  PKTHREAD Thread,
  IN  CCHAR Processor
  );

Routine Description:

    This function sets the ideal processor for the specified thread execution.

Arguments:

    Thread - Supplies a pointer to the thread whose ideal processor number is
        set to the specfied value.

    Processor - Supplies the number of the ideal processor (the distinguished
        value MAXIMUM_PROCESSORS indicates that there is no ideal processor).

Return Value:

    The previous ideal processor number.