función MPI_Mprobe

Bloqueo de sondeos para un mensaje. Proporciona un mecanismo para recibir el mensaje específico que se ha coinciden independientemente de las operaciones de sondeo o recepción intermedias. El mensaje coincidente se desconecta de la cola de recepción, lo que proporciona a la aplicación la oportunidad de decidir cómo recibir el mensaje en función de la información devuelta por la operación de sondeo coincidente. A continuación, se recibe el mensaje coincidente mediante la función MPI_Mrecv o MPI_Imrecv .

Sintaxis

int MPIAPI MPI_Mprobe(
  _In_  int         source,
  _In_  int         tag,
  _In_  MPI_Comm    comm,
  _Out_ MPI_Message *message,
  _Out_ MPI_Status  *status
);

Parámetros

• source [in]
  Clasificación de origen o MPI_ANY_SOURCE.

• tag [in]
  Etiqueta de mensaje o MPI_ANY_TAG.

• comm [in]
  Controlador del comunicador MPI.

• message [out]
  Al devolver, contiene un puntero al mensaje coincidente.

• status [out]
  Al devolver, contiene un puntero a una estructura de MPI_Status donde se almacena información sobre el mensaje.

Valor devuelto

Devuelve MPI_SUCCESS si se realiza correctamente. De lo contrario, el valor devuelto es un código de error.

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

Fortran

    MPI_MPROBE(SOURCE, TAG, COMM, MESSAGE, STATUS, IERROR)
          INTEGER SOURCE, TAG, COMM, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR

Comentarios

Esta función se comporta como MPI_Improbe , salvo que se trata de una llamada de bloqueo que solo devuelve después de encontrar un mensaje coincidente.

Requisitos

Consulte también

Funciones de punto a punto de MPI

MPI_Improbe

MPI_Recv

MPI_Imrecv