MPI_Comm_free_keyval, funkcja

Zwalnia zachowany klucz atrybutu.

Składnia

int MPIAPI MPI_Comm_free_keyval(
   _Inout_ int *comm_keyval
);

Parametry

• comm_keyval
  Wartość klucza.

Wartość zwracana

Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze IERROR .

Fortran

    MPI_COMM_FREE_KEYVAL(COMM_KEYVAL, IERROR)
        INTEGER COMM_KEYVAL, IERROR

Uwagi

Ta funkcja ustawia wartość klucza na wartość MPI_KEYVAL_INVALID. Należy pamiętać, że nie jest błędne, aby uwolnić klucz atrybutu, który jest używany, ponieważ rzeczywista bezpłatna nie następuje, dopóki wszystkie odwołania (w innych komunikatorach w procesie) do klucza zostały uwolnione. Odwołania te muszą być wyzwolone przez program, albo za pośrednictwem wywołań, aby MPI_Comm_delete_attr , że wolne jedno wystąpienie atrybutu, lub przez wywołania MPI_Comm_free, które zwalniają wszystkie wystąpienia atrybutów skojarzone z freed communicator.

Wymagania

Produkt	Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll

Zobacz też

Funkcje buforowania MPI