NI DIGITAL PATTERN DRIVER Attributes Functions - ni/grpc-device GitHub Wiki
- niDigital_GetAttributeViInt32
- niDigital_GetAttributeViInt64
- niDigital_GetAttributeViReal64
- niDigital_GetAttributeViString
- niDigital_GetAttributeViSession
- niDigital_GetAttributeViBoolean
- niDigital_SetAttributeViInt32
- niDigital_SetAttributeViInt64
- niDigital_SetAttributeViReal64
- niDigital_SetAttributeViString
- niDigital_SetAttributeViSession
- niDigital_SetAttributeViBoolean
- niDigital_ResetAttribute
Queries the value of a ViInt32 attribute. Use this function to get the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_GetAttributeViInt32 (ViSession vi, ViConstString channelList, ViAttr attribute, viInt32* value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The returned current value of the attribute; pass the address of a ViInt32 variable. |
Return value: Reports the status of the operation.
Queries the value of a ViInt64 attribute. Use this function to get the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_GetAttributeViInt64 (ViSession vi, ViConstString channelList, ViAttr attribute, ViInt64* value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The returned current value of the attribute; pass the address of a ViInt64 variable. |
Return value: Reports the status of the operation.
This function queries the value of a ViReal64 attribute. Use this function to get the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_GetAttributeViReal64 (ViSession vi, ViConstString channelList, ViAttr attribute, ViReal64* value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The returned current value of the attribute; pass the address of a ViReal64 variable. |
Return value: Reports the status of the operation.
Queries the value of a ViString attribute. Use this function to get the values of digital pattern instrument-specific attributes and inherent IVI attributes.
You must provide a ViChar array to serve as a buffer for the value. You pass the number of bytes in the buffer as the bufferSize. If the current value of the attribute, including the terminating NULL byte, is larger than the size you indicate in the bufferSize, the function copies (bufferSize - 1) bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the bufferSize you must pass to get the entire value. For example, if the value is "123456" and the bufferSize is 4, the function places "123" into the buffer and returns 7. If you want to call this function just to get the required buffer size, you can pass 0 for the bufferSize and VI_NULL for the value.
C Function Prototype: ViStatus niDigital_GetAttributeViString (ViSession vi, ViConstString channelList, ViAttr attribute, ViInt32 bufferSize, ViChar[] value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
bufferSize | The number of elements in the ViChar array you specify for value. |
Output | |
value | The buffer in which the function returns the current value of the attribute; the buffer must be of type ViChar and have at least as many bytes as indicated in the bufferSize. |
Return value: Reports the status of the operation.
Queries the value of a ViSession attribute. Use this function to get the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_GetAttributeViSession (ViSession vi, ViConstString channelList, ViAttr attribute, ViSession* value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The returned current value of the attribute; pass the address of a ViSession variable. |
Return value: Reports the status of the operation.
Queries the value of a ViBoolean attribute. Use this function to get the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_GetAttributeViBoolean (ViSession vi, ViConstString channelList, ViAttr attribute, ViBoolean* value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The returned current value of the attribute; pass the address of a ViBoolean variable. |
Return value: Reports the status of the operation.
Sets the value of a ViInt32 attribute. Use this function to set the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_SetAttributeViInt32 (ViSession vi, ViConstString channelList, ViAttr attribute, ViInt32 value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The value to which you want to set the attribute; some of the values might not be valid depending on the current settings of the instrument session. |
Return value: Reports the status of the operation.
Sets the value of a ViInt64 attribute. Use this function to set the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_SetAttributeViInt64 (ViSession vi, ViConstString channelList, ViAttr attribute, ViInt64 value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The value to which you want to set the attribute; some of the values might not be valid depending on the current settings of the instrument session. |
Return value: Reports the status of the operation.
Sets the value of a ViIntReal64 attribute. Use this function to set the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_SetAttributeViReal64 (ViSession vi, ViConstString channelList, ViAttr attribute, ViReal64 value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The value to which you want to set the attribute; some of the values might not be valid depending on the current settings of the instrument session. |
Return value: Reports the status of the operation.
Sets the value of a ViString attribute. Use this function to set the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_SetAttributeViString (ViSession vi, ViConstString channelList, ViAttr attribute, ViConstString value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The value to which you want to set the attribute; some of the values might not be valid depending on the current settings of the instrument session. |
Return value: Reports the status of the operation.
Sets the value of a ViSession attribute. Use this function to set the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_SetAttributeViSession (ViSession vi, ViConstString channelList, ViAttr attribute, ViSession value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The value to which you want to set the attribute; some of the values might not be valid depending on the current settings of the instrument session. |
Return value: Reports the status of the operation.
Sets the value of a ViBoolean attribute. Use this function to set the values of digital pattern instrument-specific attributes and inherent IVI attributes.
C Function Prototype: ViStatus niDigital_SetAttributeViBoolean (ViSession vi, ViConstString channelList, ViAttr attribute, ViBoolean value)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attribute | The ID of an attribute. |
Output | |
value | The value to which you want to set the attribute; some of the values might not be valid depending on the current settings of the instrument session. |
Return value: Reports the status of the operation.
Resets the attribute to its default value.
C Function Prototype: ViStatus niDigital_ResetAttribute (ViSession vi, ViConstString channelList, ViAttr attributeId)
Parameter | Description |
---|---|
vi | The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns. |
channelList |
List of channel names or list of pins. Do not pass a mix of channel names and pin names. An empty string denotes all digital pattern instrument channels. Pin names and pin groups apply to all enabled sites, unless the pin name explicitly specifies the site. You can specify a pin in a specific site using the form siteN/pinName, where N is the site number. This function ignores pins that are not mapped to the digital pattern instrument. Specify channel names using the form PXI1Slot3/0,2-3 or PXI1Slot3/0,PXI1Slot3/2-3, where PXI1Slot3 is the instrument resource name and 0, 2, 3 are channel names. To specify channels from multiple instruments, use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3. The instruments must be in the same chassis. |
attributeId | Pass the ID of an attribute. |
Return value: Reports the status of the operation.