Partilhar via


função MPI_Request_free

Liberta um objeto de pedido de comunicação.

Sintaxe

int MPIAPI MPI_Request_free(
   _Inout_ MPI_Request *request
);

Parâmetros

  • pedido
    Pedido de comunicação.

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é armazenado no parâmetro IERROR .

Fortran

    MPI_REQUEST_FREE(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

Observações

Normalmente, esta rotina é utilizada para libertar pedidos persistentes inativos criados com MPI_Recv_init ou MPI_Send_init e amigos. Também é permitido libertar um pedido ativo. No entanto, uma vez libertado, o pedido já não pode ser utilizado numa rotina de espera ou teste (por exemplo, MPI_Wait) para determinar a conclusão.

Esta rotina também pode ser utilizada para libertar pedidos não persistentes, como os criados com MPI_Irecv ou MPI_Isend e amigos. Tal como os pedidos persistentes ativos, uma vez libertados, o pedido já não pode ser utilizado com rotinas de teste/espera para determinar a conclusão.

Requisitos

Produto

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities

Cabeçalho

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Ver também

Funções Ponto a Ponto do MPI