VMS Help  —  System Services, $GETDVI
    Returns information related to the primary and secondary device
    characteristics of an I/O device.

                                   NOTE

       All pathname-related information pertains only to Alpha and
       Integrity server systems.

    For synchronous completion, use the Get Device/Volume Information
    and Wait ($GETDVIW) service. The $GETDVIW service is identical to
    the $GETDVI service in every way except that $GETDVIW returns to
    the caller with the requested information.

    For additional information about system service completion, see
    the Synchronize ($SYNCH) service.

                          NOTE ABOUT ITEM CODES

       For item codes that return a string data type, failure to
       pass in a buffer that is large enough to hold the returned
       data results in silent data truncation. When $GETDVI
       completes, VSI recommends that you check the returned length
       field of an item list descriptor for each item code that
       can return a string. If the returned length is equal to the
       size of the buffer allocated to hold the returned data, the
       data might have been truncated. In that case, call $GETDVI
       iteratively with a larger buffer until the length of the
       returned data is less than the size of the buffer allocated.

       Unless the description of an item code specifies otherwise,
       VSI recommends that you use a buffer of 32 bytes to hold
       the returned string. $GETDVI pads the unused portion of the
       buffer with null characters.

    Format

      SYS$GETDVI  [efn] ,[chan] ,[devnam] ,itmlst [,iosb] [,astadr]

                  [,astprm] [,nullarg] [,pathname]

    C Prototype

      int sys$getdvi  (unsigned int efn, unsigned short int chan,

                      void *devnam, void *itmlst, struct _iosb *iosb,

                      void (*astadr)(__unknown_params), int astprm,

                      struct _generic_64 *nullarg,...);
Additional Information: explode extract
Arguments
Close Help