Retrieves direct I/O driver settings
Procedure:
H5P_GET_FAPL_DIRECT ( fapl_id, alignment, block_size, cbuf_size )
Signature:
herr_t H5Pget_fapl_direct(
hid_t fapl_id,
size_t *alignment,
size_t *block_size,
size_t *cbuf_size
)
Fortran90 Interface: H5Pget_fapl_direct_f
SUBROUTINE H5Pget_fapl_direct_f(fapl_id, alignment, block_size, cbuf_size, &
hdferr)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: fapl_id ! File access property list identifier
INTEGER(SIZE_T), INTENT(OUT) :: alignment
! Required memory alignment boundary!
INTEGER(SIZE_T), INTENT(OUT) :: block_size
! File system block size
INTEGER(SIZE_T), INTENT(OUT) :: cbuf_size
! Copy buffer size
INTEGER, INTENT(OUT) :: hdferr ! Error code
! 0 on success and -1 on failure
END SUBROUTINE H5Pget_fapl_direct_f
Parameters:
hid_t fapl_id | IN: File access property list identifier |
size_t *alignment | OUT: Required memory alignment boundary |
size_t *block_size | OUT: File system block size |
size_t *cbuf_size | OUT: Copy buffer size |
Description:
H5P_GET_FAPL_DIRECT retrieves the required memory alignment (alignment
), file system block size (block_size
), and copy buffer size (cbuf_size
) settings for the direct I/O driver, H5FD_DIRECT
, from the file access property list fapl_id
.
See H5P_SET_FAPL_DIRECT for discussion of these values, requirements, and important considerations.
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Example:
History:
Release | Change |
---|
1.8.0 | Function introduced in this release. |
--- Last Modified: July 19, 2019 | 10:33 AM