Online Development Notebook > Index > Programming Overview > DLL Commands > DebugString

DebugString - Return the contents of the debug string

---

Description:

This is a USBm.dll function that returns a string with debug information.

Command Syntax:

true⁄false USBm_DebugString( string )

The USBm_DebugString function syntax has these parts:

Remarks:

In VB the string passed as an argument must be large enough to hold all the characters that the function places in the string. The best way to acheive this is to set the string to a large size with the String function as in this code:

strStrng = String(250, " ")

Note: USBm_DebugString always returns TRUE.

Note: USBm_DebugString does not affect the internal error string.

VB Declaration (USBmAPI.bas)

Public Declare Function USBm_DebugString _     Lib "USBm.dll" _         (ByVal debugstrng As String) _     As Integer

VB Example

Dim strng As String * 255     USBm_DebugString strng     frmStatus.lstDevices.AddItem "Debug: " & strng

This code fragment shows that strng is loaded with the "debug" text of the DLL. Assuming that the form called "Main" exists with a text box called "Info", the "debug" information will be made visible to the user.

C Prototype

int USBm_DebugString( char *errorstring );

C Example

RobotBASIC

Recent Error and Debug String are handled by the RobotBASIC function usbm_ErrorSpecs().

usbm_ErrorSpecs()

Returns a string that contains information about the recent error string and debug string if any in the DLL. There are two sections seperated by the | character. You can use the Extract() function to extract each section seperately if desired. The sections are:

Recent Error

Debug String

---

Hardware:  U401 USB Interface    U421 USB Interface   U451 USB Interface

Programming:  USBm DLL Programming    Download Files

Application Notes:  U4x1 Application Notes    Misc Applications and Information    FAQ

While every effort has been made to make sure that the information posted on this site is correct, the author can not be held liable for any damages whatsoever for losses as a result of the application of this information. Use this information at your own risk.

USBmicro can design your custom and semi-custom USB product. Email about USB design can be directed to " Robert " at usbmicro.com.

Copyright © USBmicro, L.L.C., 2002-2010