MPI_Grequest_query_function 애플리케이션 정의 함수 이름의 자리 표시자입니다.
구문
int MPI_Grequest_query_function(
_In_opt_ void *extra_state,
_Out_ MPI_Status *status
);
매개 변수
extra_state [in, optional]
추가 상태입니다.상태 [out]
MPI 상태 개체입니다.
반환 값
모든 콜백 함수는 오류 코드를 반환합니다. 코드가 다시 전달되고 콜백 함수를 호출한 MPI 함수의 오류 코드에 적절하게 처리됩니다. 예를 들어 오류 코드가 반환되면 콜백 함수에서 반환된 오류 코드는 콜백 함수를 호출한 MPI 함수에서 반환됩니다. MPI_ 경우{Wait|Test}query_fn 및 free_fn 모두 호출하는 모든 호출, MPI 호출은 마지막 콜백에서 반환된 오류 코드, 즉 free_fn 반환합니다. MPI_{Wait| 호출에서 하나 이상의 요청이 있는 경우 Test}{some|all} 이(가) 실패하면 MPI 호출이 MPI_ERR_IN_STATUS 반환됩니다. 이러한 경우 MPI 호출이 상태 배열을 전달한 경우 MPI는 완료된 일반화된 요청에 해당하는 각 상태의 free_fn 콜백 함수의 해당 호출에서 반환되는 오류 코드를 반환합니다. 그러나 MPI 함수가 MPI_STATUSES_IGNORE 전달된 경우 각 콜백 함수에서 반환된 개별 오류 코드가 손실됩니다.
Fortran
SUBROUTINE GREQUEST_QUERY_FUNCTION(EXTRA_STATE, STATUS, IERROR)
INTEGER STATUS(MPI_STATUS_SIZE), IERROR
INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE
설명
query_fn 함수는 일반화된 요청에 대해 반환해야 하는 상태 계산합니다. 상태 요청의 취소 성공/실패에 대한 정보도 포함합니다(MPI_Test_cancelled 반환할 결과).
MPI_{Wait|에 의해 query_fn 콜백이 호출됩니다.이 콜백과 연결된 일반화된 요청을 완료한 Test}{any|some|all} 호출입니다. 콜백 함수는 호출이 발생할 때 요청이 완료된 경우 MPI_Request_get_status 호출에 의해 호출됩니다. 두 경우 모두 콜백은 사용자가 MPI 호출에 전달한 해당 상태 변수에 대한 참조를 전달합니다. 콜백 함수에서 설정한 상태 MPI 호출에 의해 반환됩니다. 사용자가 query_fn 호출하는 MPI 함수에 MPI_STATUS_IGNORE 또는 MPI_STATUSES_IGNORE 제공한 경우 MPI는 유효한 상태 개체를 query_fn 전달하고 콜백 함수를 반환하면 이 상태 무시됩니다. query_fn 요청에 대해 MPI_Grequest_complete 호출된 후에만 호출됩니다. 사용자가 이 요청에 대해 MPI_Request_get_status 여러 번 호출하는 경우와 같이 동일한 일반화된 요청에 대해 여러 번 호출될 수 있습니다. MPI_{Wait|에 대한 호출도 참고 하세요.Test}{some|all} 은 ( 는) MPI 호출에 의해 완료된 각 일반화된 요청에 대해 하나씩 query_fn 콜백 함수를 여러 번 호출할 수 있습니다. 이러한 호출의 순서는 MPI에 의해 지정되지 않습니다.
요구 사항
제품 |
HPC 팩 2012 MS-MPI 재배포 가능 패키지, HPC 팩 2008 R2 MS-MPI 재배포 가능 패키지, HPC Pack 2008 MS-MPI 재배포 가능 패키지 또는 HPC 팩 2008 클라이언트 유틸리티 |
헤더 |
Mpi.h; Mpif.h |