Compartilhar via

função MPI_Request_free

  • Artigo

Libera um objeto de solicitação de comunicação.

Sintaxe

int MPIAPI MPI_Request_free(
   _Inout_ MPI_Request *request
);

Parâmetros

  • solicitação
    Solicitação de comunicação.

Retornar valor

Retorna MPI_SUCCESS em caso de êxito. Caso contrário, o valor retornado será um código de erro.

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

Fortran

    MPI_REQUEST_FREE(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

Comentários

Normalmente, essa rotina é usada para liberar solicitações persistentes inativas criadas com MPI_Recv_init ou MPI_Send_init e amigos. Também é permitido liberar uma solicitação ativa. No entanto, depois de liberada, a solicitação não pode mais ser usada em uma rotina de espera ou teste (por exemplo, MPI_Wait) para determinar a conclusão.

Essa rotina também pode ser usada para liberar solicitações não persistentes, como aquelas criadas com MPI_Irecv ou MPI_Isend e amigos. Assim como as solicitações persistentes ativas, depois de liberadas, a solicitação não pode mais ser usada com rotinas de teste/espera para determinar a conclusão.

Requisitos

Produto

Pacote Redistribuível do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008

parâmetro

 Mpi.h; Mpif.h

Biblioteca

 Msmpi.lib

DLL

 Msmpi.dll

Confira também

Funções ponto a ponto do MPI