D64H_Di_Async_Dblbuf_Halfready - ICP DAS USA PCI-D64HU User Manual

4.4

d64h_di_async_dblbuf_halfready

VC6
short d64h_di_async_dblbuf_halfready (BYTE bCardID, BOOLEAN *pHalfReady)
VB6
d64h_di_async_dblbuf_halfready (ByVal bCardID As Byte, ByRef pHalfReady As Byte) As
Integer
Description:
This function checks the availability of ring-buffer when the digital-input acquisition is configured as
double-buffer mode. If the pHalfReady indicates the ring-buffer is ready, please call
d64h_di_async_dblbuf_transfer() to copy the available acquisition data.
Parameters:
bCardID: the specific Card ID that is configured with the on-board Dip-Switch.
pHalfReady: the pointer to the memory that stores the availability of ring-buffer.
Return Code:
SUCCESS_NO_ERROR: The function returns successfully.
ERROR_INVALID_CARD_ID: There is no active PCI-D64HU card configured with bCardID, or the
ERROR_ACCESS_VIOLATION_DATA_COPY: Some system exception occurs while copying
ERROR_DI_ASYNC_HALF_READY: Fail to check the availability of ring-buffer.
PCI-D64HU Function Reference Version
given Card ID is invalid (for instance, Card ID is assigned to 254).
memory, please check the pointer-type parameter you assign to this function.
21