viOpenDefaultRM(3visa)

💖 NAME 💖

viOpenDefaultRM — create and return a handle to the default VISA resource manager.

Okay so this page is living in the LibreVISA Programmers' Manual, and it's all about viOpenDefaultRM(3visa). If you're tryna find and open instruments or instrument buses, this handle is literally how you start. Periodt. 💅

✨ SYNOPSIS ✨

#include <visa.h>

ViStatus viOpenDefaultRM(ViSession *resource_manager);

🌸 DESCRIPTION 🌸

Bestie, listen. This function creates a new handle referencing the default VISA resource manager, and stores it at the address given by the resource_manager parameter. No cap.

That handle can then be used to find and open instruments or instrument buses. It's giving main character energy because this is typically the first function invoked by client applications. Like, the opener. The vibe check. ✨

When the handle is no longer needed, it should be closed using the viClose() function. Don't ghost it, bestie. Close it. 💖

iykyk: handle first, close later.

💅 RETURN VALUE 💅

On success, VI_SUCCESS is returned, and the new handle is stored at the given address. Slay. ✅

On failure, an error code is returned, and the new handle is initialized to VI_NULL. So if it flops, you get an error and the handle is set to VI_NULL. Not me getting an error code and a null handle at the same time. 😭

🦋 SEE ALSO 🦋

• viClose(3visa)
• viFindRsrc(3visa)
• viOpen(3visa)
• visa(7visa)

xoxo, LibreVISA 💖 27 January 2013 🎀