ADMA_ALLOC_BUFERS Sample Clauses

ADMA_ALLOC_BUFERS. C# and LabVIEW applications may find it more convenient to allow the API to allocate and manage a list of buffers available to be filled by the board. These applications should call AlazarBeforeAsyncRead with the AMDA_ALLOC_BUFFERS option selected in the “Flags” parameter. This option will cause the API to allocate and manage a list of buffers available to be filled by the board. The application must call AlazarWaitNextAsyncBufferComplete to wait for a buffer to be filled. When the board receives sufficient trigger events to fill a buffer, the API will copy the data from the internal buffer to the user-supplied buffer. The following code fragment outlines how make an AutoDMA acquisition using ADMA_ALLOC_BUFERS flag and AlazarWaitNextAsyncBufferComplete. // Allow the API to allocate and manage AutoDMA buffers flags |= ADMA_ALLOC_BUFFERS; // Configure a board to make an AutoDMA acquisition AlazarBeforeAsyncRead( handle, // HANDLE -- board handle channelMask, // U32 -- enabled channel mask -(long)preTriggerSamples, // long -- trigger offset samplesPerRecord, // U32 -- samples per record recordsPerBuffer, // U32 -- records per buffer recordsPerAcquisition, // U32 -- records per acquisition flags // U32 -- AutoDMA mode and options ); // Arm the board to begin the acquisition AlazarStartCapture(handle); // Wait for each buffer in the acquisition to be filled RETURN_CODE retCode = ApiSuccess; while (retCode == ApiSuccess) { // Wait for the board to receive sufficient // trigger events to fill an internal AutoDMA buffer. // The API will copy data from the internal buffer // to the user-supplied buffer. retCode = AlazarWaitNextAsyncBufferComplete( handle, // HANDLE -- board handle pBuffer, // void* -- buffer to receive data bytesToCopy, // U32 -- bytes to copy into buffer timeout_ms // U32 -- time to wait for buffer ); // The buffer is full, process it // Note that while the application processes this buffer, // the board is filling the next available internal buffer // as trigger events arrive. ProcessBuffer(pBuffer, bytesPerBuffer); } // Abort the acquisition and release resources. // This function must be called after an acquisition. AlazarAbortAsyncRead(boardHandle); See “%ATS_SDK_DIR%\Samples\DualPort\CS_WaitNextBuffer” for a full sample program that demonstrates make an AutoDMA acquisition using ADMA_ALLOC_BUFFERS. An application can get or set the number of DMA buffers allocated by the API by calling AlazarGetParameter or AlazarSetParameter with the paramete...