set_task_execution_resources-Funktion
Schränkt die Ausführungsressourcen durch die Affinität festgelegten internen Worker-Threads die Parallelität Runtime verwendet.
Es ist zulässig, diese Methode aufzurufen, nur vor dem Erstellen der Ressourcen-Manager erstellt wurde, oder zwischen zwei Ressourcen-Manager-Leben.Es kann mehrmals aufgerufen werden, solange der Ressourcen-Manager zum Zeitpunkt des Aufrufs nicht vorhanden ist.Nachdem eine Beschränkung für die Affinität festgelegt wurde, bleibt wirksam bis der nächste gültige Aufruf der set_task_execution_resources Methode.
Die Affinitätsmaske bereitgestellten muss keine Teilmenge der Affinitätsmaske Prozess sein.Die Prozessaffinität wird bei Bedarf aktualisiert.
void __cdecl set_task_execution_resources(
DWORD_PTR _ProcessAffinityMask
);
void __cdecl set_task_execution_resources(
unsigned short _Count,
PGROUP_AFFINITY _PGroupAffinity
);
Parameter
_ProcessAffinityMask
Affinity Mask, die Parallelität Runtime-Worker-Threads beschränkt werden sollen.Verwenden Sie diese Methode auf einem System mit mehr als 64 Hardwarethreads nur, wenn Sie die Parallelität Runtime auf eine Teilmenge der aktuellen Prozessor beschränken möchten.Im Allgemeinen sollten Sie die Version der Methode verwenden, die ein Array von Gruppe Affinitäten als Parameter, um Affinität auf Computern mit mehr als 64 Hardwarethreads zu beschränken._Count
Die Anzahl der GROUP_AFFINITY Einträge im Array angegebenen durch den Parameter _PGroupAffinity._PGroupAffinity
Ein Array von GROUP_AFFINITY Einträge.
Hinweise
Sonst löst die Methode eine Invalid_operation Ausnahme, wenn ein Ressourcen-Manager zur Zeit vorhanden ist, aufgerufen wird, und eine werden Invalid_argument Ausnahme, wenn die Affinität Ergebnisse in eine leere Menge von Ressourcen angegeben.
Die Version der Methode, die ein Array von Gruppe Affinitäten als Parameter akzeptiert sollte nur auf Betriebssystemen mit Windows 7-Version oder höher sein.Andernfalls ein Invalid_operation Ausnahme wird ausgelöst.
Ändern die Prozessaffinität programmgesteuert nach dem Aufrufen dieser Methode wird nicht der Ressourcen-Manager, die Affinität neu zu bewerten, die auf die beschränkt verursachen.Daher sollten alle Änderungen verarbeitet Affinität erfolgen vor dem Aufrufen dieser Methode.
Anforderungen
Header: concrt.h
Namespace: Parallelität