ADIC 601355 Rev A

API Guide

601355 Rev A API Functions 2-385

Functions

31 default:

32 printf(“*** A Select Error

Occurred ***\n”);

33 break;

34 }

35 return(rc);

36 }

Notes VS_Select calls fail if VS_Initialize has not been

invoked.

VS_Select is used only when the API is operating in

asynchronous mode. Therefore, clients that use synchronous

processing do not use the VS_Select routine.

The VolServ API uses the client dispatch routine identification

information, set with the VS_Global_SetDefaults function

or with the command default function, to determine which

routine to notify when intermediate and final command status is

received.

The total amount time the API waits for status is

VSID_TIMEOUT_VALUE.

VS_Select returns error codes instead of the normal

VST_BOOLEAN values (VSE_TRUE, VSE_FALSE). This

simplifies client code when performing asynchronous

processing. Client can use the “switch” statement on the return

code directly from the routine without having to retrieve error

codes.