RFmx BT CVI

RFmxBT_Close

  • Updated2024-10-14
  • 1 minute(s) read

RFmxBT_Close

int32 __stdcall RFmxBT_Close (niRFmxInstrHandle instrumentHandle, int32 forceDestroy);

Purpose

Closes the RFmx session.

This function is a wrapper over the NI-RFmx Instruments API, and calls the RFmxInstr_Close function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxBT_Initialize function.
forceDestroy int32 Specifies whether to destroy the NI-RFmx session.

RFMXBT_VAL_FALSE (0) Destroys the NI-RFmx session. Call the RFmxBT_Close function a number of times equal to the number of times you obtained a reference to the NI-RFmx session.
RFMXBT_VAL_TRUE (1) Destroys the NI-RFmx session. You do not have to call the RFmxBT_Close function multiple times. Destroying the NI-RFmx session invalidates all references to the session.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxBT_GetError function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

Log in to get a better experience