viFindRsrc(3)

HP-UX

NAME

viFindRsrc − Queries a VTL system to locate a device

SYNOPSIS

viFindRsrc(ViSession sesn, ViString expr, ViPFindList
findList, ViPUInt32 retcnt, ViPRsrc instrDesc);

Description

This function queries a VTL system to locate the devices associated with a specified interface. This function matches the value specified in the expr parameter with the devices available for a particular interface. On successful completion, it returns the first device found in the list and returns a count to indicate if there were more devices found for the designated interface. This function also returns a handle to a find list. This handle points to the list of devices, and it must be used as an input to viFindNext. When this handle is no longer needed, it should be passed to viClose.

Parameters

sesn An input parameter. Resource Manager session (should always be the Default Resource Manager for VTL returned from viOpenDefaultRM).

expr An input parameter. This expression sets the criteria to search an interface or all interfaces for existing devices. (See the following table for description string format.)

findList An output parameter. Returns a handle identifying this search session. This handle will be used as an input in viFindNext.

retcnt An output parameter. Number of matches.

instrDesc An output parameter. Returns a string identifying the location of a device. Strings can then be passed to viOpen to establish a session to the given device.

Description String for expr Parameter

Interface    Expression
GPIB      GPIB?*INSTR
VXI        VXI?*INST
GPIB-VXI   GPIB-VXI?*INSTR
All        ?*INSTR

Return Values

This is the functional return status. It returns either a completion code or an error code as follows.

VI_SUCCESS Resource(s) found.

VI_ERROR_INV_SESSION VI_ERROR_INV_OBJECT The given session or object reference is invalid (both are the same value).

VI_ERROR_NSUP_OPER The given sesn does not support this function.

VI_ERROR_INV_EXPR Invalid expression specified for search.

VI_ERROR_RSRC_NFOUND Specified expression does not match any devices.

AUTHOR

viFindRsrc was developed by HP

Hewlett-Packard Comapny — September 29, 1999

Museum