MSMPI_Queuelock_acquire, fonction
Acquiert le verrou global de la bibliothèque Microsoft MPI. La file d’attente de verrous est une file d’attente FIFO (First-In-First Out).
Syntaxe
void MSMPI_Queuelock_acquire(
_Out_ MSMPI_Lock_queue *queue
);
Paramètres
-
file d’attente [out]
Pointe vers une structure de MSMPI_Lock_queue fournie par l’utilisateur qui représente la position du thread appelant dans la file d’attente jusqu’à ce que l’utilisateur libère le verrou à l’aide de la fonction MSMPI_Queuelock_release .
Valeur renvoyée
Cette fonction ne retourne pas de valeur.
Notes
Le comportement de cette fonction dépend du niveau de prise en charge des threads en cours d’utilisation. Lorsque la prise en charge du thread est MPI_THREAD_SERIALIZED ou inférieure, cette fonction acquiert le verrou global Microsoft MPI, qui fournit la sérialisation FIFO des appelants et interrompt tous les appels de fonction MSMPI_Waitsome_interruptible en cours.
Les applications doivent normalement allouer la structure de file d’attente sur la pile chaque fois qu’elles acquièrent le verrou.
Pour éviter les erreurs lorsque les threads utilisent MSMPI_Waitsome_interruptible dans les applications multithread, tous les threads doivent acquérir le verrou global avant d’appeler des fonctions MPI.
Cette fonction est une extension de la norme.
Configuration requise
Produit |
Package redistribuable MS-MPI HPC Pack 2012, package redistribuable HPC Pack 2008 R2 MS-MPI, package redistribuable MS-MPI HPC Pack 2008 ou utilitaires clients HPC Pack 2008 |
En-tête |
Mpi.h |
Bibliothèque |
Msmpi.lib |
DLL |
Msmpi.dll |