Compartir a través de


MPI_Init_thread función

Inicializa el entorno de ejecución del proceso de MPI que realiza la llamada para la ejecución en subproceso.

Sintaxis

int MPIAPI MPI_Init_thread(
  _In_opt_ int                        *argc,
           _In_opt_count_(*argc) char ***argv,
  _In_     int                        required,
  _Out_    int                        *provided
);

Parámetros

  • argc [in, optional]
    Puntero al número de argumentos del programa. Este valor puede ser NULL.

  • argv [opcional]
    Puntero a la lista de argumentos del programa. Este valor puede ser NULL.

  • obligatorio [in]
    Nivel de compatibilidad con subprocesos deseado. Varios procesos de MPI en el mismo trabajo pueden usar valores diferentes.

    MPI_THREAD_SINGLE Solo se ejecutará un único subproceso en el programa.
    MPI_THREAD_FUNNELED El proceso puede contener varios subprocesos, pero el subproceso que llamó a MPI_Init_thread es el único que realiza llamadas a función MPI.
    MPI_THREAD_SERIALIZED El proceso puede contener varios subprocesos y todos esos subprocesos pueden realizar llamadas a funciones MPI, pero solo una a la vez.
    MPI_THREAD_MULTIPLE Varios subprocesos de aplicación pueden llamar a funciones MPI sin restricciones. Este valor solo se admite actualmente en MS-MPI V6 que se ejecuta en Windows Server 2012, Windows Server 2012 R2, Windows 8 y Windows 8.1.

     

  • proporcionado [out]
    Nivel de compatibilidad con subprocesos proporcionado. El valor devuelto será de la tabla anterior.

     

Valor devuelto

MPI_SUCCESS si la función devuelve correctamente. Otros códigos de error si se produjo un error en la llamada por otros motivos (por ejemplo, argumentos no válidos).

En Fortran, el valor devuelto se almacena en el parámetro IERROR .

Fortran

    MPI_INIT_THREAD(REQUIRED, PROVIDED, IERROR)
        INTEGER REQUIRED, PROVIDED, IERROR

Comentarios

Solo un subproceso debe llamar a esta función. Ese subproceso se conoce como "Subproceso principal" y debe ser el mismo subproceso para llamar a MPI_Finalize.

El enlace Fortran de MPI_Init_thread no acepta los parámetros ARGC y ARGV.

Requisitos

Producto

Paquete redistribuible DE HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Client Utilities

Encabezado

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

Archivo DLL

Msmpi.dll

Consulte también

Funciones externas de MPI

MPI_Finalize

MPI_Init