Description This command indicates whether or not the system is in Vendor-Dependent Mode. It will also indicate which Applications have not responded to the VDM Request Enter Event or VDM Request Exit Event if the current Service status is WFS_VDM_ENTERPENDING or WFS_VDM_EXITPENDING respectively.
Input Param None.
Output Param LPWFSVDMSTATUS lpStatus;
typedef struct _wfs_vdm_status
{
WORD wDevice;
WORD wService;
LPWFSVDMAPPSTATUS * lppAppStatus;
LPSTR lpszExtra;
} WFSVDMSTATUS, * LPWFSVDMSTATUS;
wDevice
Specifies the status of the Vendor Dependent Mode Service Class. Status will be one of the following flags:
Value Meaning
WFS_VDM_DEVONLINE Vendor Dependent Mode service available.
WFS_VDM_DEVOFFLINE Vendor Dependent Mode service unavailable.
wService
Specifies the Service state as one of the following flags:
Value Meaning
WFS_VDM_ENTERPENDING Vendor Dependent Mode Enter Request pending.
WFS_VDM_ACTIVE Vendor Dependent Mode Active.
WFS_VDM_EXITPENDING Vendor Dependent Mode Exit Request pending.
WFS_VDM_INACTIVE Vendor Dependent Mode Inactive.
lppAppStatus
Pointer to a null-terminated array of pointers to Application Status structures:
typedef struct _wfs_vdm_appstatus
{
LPSTR lpszAppID;
WORD wAppStatus;
} WFSVDMAPPSTATUS, * LPWFSVDMAPPSTATUS;
lpszAppID
Application ID string
wAppStatus
Specifies whether the particular Application is ready for the System to enter or exit Vendor Dependent Mode. Values can be one of the following:
Value Meaning
WFS_VDM_ENTERPENDING Application not yet ready to Enter VDM.
WFS_VDM_ACTIVE Application ready to Enter VDM.
WFS_VDM_EXITPENDING Application not yet ready to Exit VDM.
WFS_VDM_INACTIVE Application ready to Exit VDM.
lpszExtra
Specifies a list of vendor-specific, or any other extended, information. The information is returned as a series of "key=value" strings so that it is easily extendable by service providers. Each string will be null-terminated, with the final string terminating with two null characters.
Error Codes There are no additional error codes generated by this command.
Comments Applications which require or expect specific information to be present in the lpszExtra parameter may not be device or vendor-independent.