Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
MPI_Grequest_query_function ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
int MPI_Grequest_query_function(
_In_opt_ void *extra_state,
_Out_ MPI_Status *status
);
Parameter
extra_state [in, optional]
Zusätzlicher Zustand.status [out]
MPI status-Objekt.
Rückgabewert
Alle Rückruffunktionen geben einen Fehlercode zurück. Der Code wird zurückgegeben und entsprechend dem Fehlercode von der MPI-Funktion behandelt, die die Rückruffunktion aufgerufen hat. Wenn beispielsweise Fehlercodes zurückgegeben werden, wird der von der Rückruffunktion zurückgegebene Fehlercode von der MPI-Funktion zurückgegeben, die die Rückruffunktion aufgerufen hat. Im Fall einer MPI_{Wait|Test}Jeder Aufruf, der sowohl query_fn als auch free_fn aufruft, gibt der MPI-Aufruf den Fehlercode zurück, der vom letzten Rückruf zurückgegeben wurde, nämlich free_fn. Wenn mindestens eine der Anforderungen in einem Aufruf von MPI_{Wait|Test}{some|all} fehlgeschlagen, dann gibt der MPI-Aufruf MPI_ERR_IN_STATUS zurück. Wenn der MPI-Aufruf in einem solchen Fall ein Array von Status übergeben wurde, gibt MPI in jedem Status, der einer abgeschlossenen generalisierten Anforderung entspricht, den Fehlercode zurück, der vom entsprechenden Aufruf seiner free_fn Rückruffunktion zurückgegeben wird. Wenn die MPI-Funktion jedoch MPI_STATUSES_IGNORE übergeben wurde, gehen die einzelnen Fehlercodes, die von den einzelnen Rückruffunktionen zurückgegeben werden, verloren.
Fortran
SUBROUTINE GREQUEST_QUERY_FUNCTION(EXTRA_STATE, STATUS, IERROR)
INTEGER STATUS(MPI_STATUS_SIZE), IERROR
INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE
Hinweise
Die query_fn-Funktion berechnet die status, die für die generalisierte Anforderung zurückgegeben werden soll. Die status enthält auch Informationen über den erfolgreichen/nicht erfolgreichen Abbruch der Anforderung (Ergebnis, das von MPI_Test_cancelled zurückgegeben wird).
Der query_fn Rückruf wird vom MPI_{Wait| aufgerufen.Test}{any|some|all} -Aufruf, der die generalisierte Anforderung abgeschlossen hat, die diesem Rückruf zugeordnet ist. Die Rückruffunktion wird auch durch Aufrufe von MPI_Request_get_status aufgerufen, wenn die Anforderung abgeschlossen ist, wenn der Aufruf erfolgt. In beiden Fällen wird dem Rückruf ein Verweis auf die entsprechende status Variable übergeben, die vom Benutzer an den MPI-Aufruf übergeben wird. Die durch die Rückruffunktion festgelegte status wird vom MPI-Aufruf zurückgegeben. Wenn der Benutzer MPI_STATUS_IGNORE oder MPI_STATUSES_IGNORE für die MPI-Funktion bereitgestellt hat, die dazu führt, dass query_fn aufgerufen wird, übergibt MPI ein gültiges status-Objekt an query_fn, und dieses status wird ignoriert, wenn die Rückruffunktion zurückgegeben wird. Beachten Sie, dass query_fn erst aufgerufen wird , nachdem MPI_Grequest_complete für die Anforderung aufgerufen wurde. Sie kann für dieselbe generalisierte Anforderung mehrmals aufgerufen werden, z. B. wenn der Benutzer MPI_Request_get_status mehrmals für diese Anforderung aufruft. Beachten Sie auch, dass ein Aufruf von MPI_{Wait|Test}{some|all} kann mehrere Aufrufe von query_fn Rückruffunktionen verursachen, einer für jede generalisierte Anforderung, die durch den MPI-Aufruf abgeschlossen wird. Die Reihenfolge dieser Aufrufe wird vom MPI nicht angegeben.
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 |