NI Bluetooth Toolkit Direct Test Mode

niBTDTM_CreateCustomCommand

int32 __stdcall niBTDTM_CreateCustomCommand (niBTDTMSession* session, int32 opCode[], int32 opCodeLength, int32 commandParameters[], int32 commandParametersLength, int32 returnParameters[], int32 arraySize, int32 *actualArraySize);

Purpose

Sends the specified custom command to the device under test (DUT).

Parameters

Input
Name Type Description
session niBTDTMSession Specifies the name of the communication port to which the DUT is connected.
opCode int32[] Specifies the opcode of the custom commands to send to the DUT.
opCodeLength int32 Specifies the length of the opCode array.
commandParameters int32[] Specifies an array of the input parameters required for the custom command.
commandParametersLength int32 Specifies the length of the commandParameters array.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
returnParameters int32[] Returns an array of the parameters sent by the DUT in response to the custom command.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to returnParameters array, and set the arraySize parameter to 0.

Return Value

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

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