7/21

USING THE ST7 USB DEVICE FIRMWARE UPGRADE DEVELOPMENT KIT (DFU-DK)

4.3 PROGRAMMING INTERFACE

This is the Application-programming interface of the ST7DFU.dll module. The documentation

describes the interface in C language.

4.3.1 STDFU_EnumGETNBDevices

4.3.1.1 Prototype

DWORD STDFU_EnumGetNbDevices(

PDWORD pNb,

HWND hWnd,

DWORD Message);

4.3.1.2 Description

Browses all DFU devices connected to the PC.

4.3.1.3 Parameters

pNb: pointer to the number of DFU devices

hWnd :window handle

Message: notifies an application of a change to the hardware configuration of a DFU-device.

4.3.1.4 Returned value

STDFU_NOERROR in case of success, otherwise (Error Code)

4.3.1.5 Remarks

For more details about hWnd and Message parameters please refer to Section 4.3.19

The following section provides all error codes that can be returned by any function:

STDFU_ERROR_OFFSET

0x12340000

STDFU_NOERROR

STDFU_ERROR_OFFSET

STDFU_MEMORY

(STDFU_ERROR_OFFSET+1)

STDFU_BADPARAMETER

(STDFU_ERROR_OFFSET+2)

STDFU_NOTIMPLEMENTED

(STDFU_ERROR_OFFSET+3)

STDFU_ENUMFINISHED

(STDFU_ERROR_OFFSET+4)

STDFU_OPENDRIVERERROR

(STDFU_ERROR_OFFSET+5)

STDFU_ERRORDESCRIPTORBUILDING

(STDFU_ERROR_OFFSET+6)

STDFU_PIPECREATIONERROR

(STDFU_ERROR_OFFSET+7)

STDFU_PIPERESETERROR

(STDFU_ERROR_OFFSET+8)

STDFU_PIPEABORTERROR

(STDFU_ERROR_OFFSET+9)

STDFU_STRINGDESCRIPTORERROR

(STDFU_ERROR_OFFSET+0xA)

STDFU_DRIVERISCLOSED

(STDFU_ERROR_OFFSET+0xB)

STDFU_VENDOR_RQ_PB

(STDFU_ERROR_OFFSET+0xC)

STDFU_ERRORWHILEREADING

(STDFU_ERROR_OFFSET+0xD)

STDFU_ERRORBEFOREREADING

(STDFU_ERROR_OFFSET+0xE)

STDFU_ERRORWHILEWRITING

(STDFU_ERROR_OFFSET+0xF)