Freigeben über


MPI_Win_create_dynamic-Funktion

Erstellt ein Fenster, in dem der Benutzer dynamisch steuern kann, welcher Arbeitsspeicher vom Fenster verfügbar gemacht wird.

Syntax

int MPIAPI MPI_Win_create_dynamic(
        MPI_Info info,
        MPI_Comm comm,
  _Out_ MPI_Win  *win
);

Parameter

  • info
    Info-Argument.

  • comm
    Communicator.

  • win [out]
    Vom Aufruf zurückgegebenes Window-Objekt.

Rückgabewert

Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.

In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.

Fortran

    MPI_WIN_CREATE_DYNAMIC(INFO, COMM, WIN, IERROR)
        INTEGER INFO, COMM, WIN, IERROR

Hinweise

Dies ist ein kollektiver Aufruf, der von allen Prozessen in der Gruppe von comm ausgeführt wird. Es gibt einen Fenstergewinn ohne angefügten Arbeitsspeicher zurück. Diese Routine gibt ein Fensterobjekt zurück, das von diesen Prozessen verwendet werden kann, um RMA-Vorgänge für angefügten Arbeitsspeicher auszuführen.

Das Info-Argument kann verwendet werden, um Hinweise anzugeben, die dem info-Argument für MPI_Win_create ähneln.

Bei einem Fenster, das mit MPI_Win_create_dynamic erstellt wurde, ist die target_disp für alle RMA-Funktionen die Adresse am Ziel; Das heißt, die effektive window_base ist MPI_BOTTOM und die disp_unit ist eins. Bei dynamischen Fenstern ist das argument target_disp zu RMA-Kommunikationsvorgängen nicht auf nicht negative Werte beschränkt. Benutzer sollten MPI_Get_address beim Zielprozess verwenden, um die Adresse eines Zielspeicherorts zu ermitteln und diese Adresse an den Ursprungsprozess zu übermitteln.

Anforderungen

Produkt

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

Header

Mpi.h; Mpif.h

Bibliothek

Msmpi.lib

DLL

Msmpi.dll

Weitere Informationen

MPI One-Sided Communications Functions