WDF File Access Library
The WDF File Access Library is a free API (Application Program Interface) provided as a DLL (Dynamic Link Library) that enables user applications on a Windows PC to acquire data from waveform data files (WDF) saved on Yokogawa measurement instruments. By linking the DLL, developers can build application software with functions such as getting measuring conditions and getting waveform data from recorded WDF files accessible over the PC storage environment. Dedicated DLLs are provided for waveform data saved with the DL850E series, DL350, DL950, SL2000, Yokogawa's Xviewer software, and the DLM3000, DLM3000HD, DLM5000 and DLM5000HD series. The library offers functions for getting measuring date/time, measuring trace (channel) information, measuring points, time data/measuring data, units of the time axis/measuring axis, and resolutions of the time axis/measuring axis. The software package includes the library body (DLL), DLL import library (.lib), the prototype declaration header file (WDFAPIPublic.h), and sample code for explicit DLL linking (WDFAPIWrapper.cpp).
Overview
Specifications
| Parameter | Value |
|---|---|
| Product Type | API software library (Dynamic Link Library, DLL) |
| Supported File Format | WDF (waveform data file saved on Yokogawa measurement instruments) |
| Supported Operating System | Windows 10 (32 bit or 64 bit) / Windows 11, English or Japanese version |
| Application Development Environment | Visual Studio 2017 or later |
| Runtime Requirement | Visual Studio 2017 Redistributable Package |
| License | Free of charge |
| Software Package Files | ****.dll (library body); ****.lib (DLL import library); WDFAPIPublic.h (header file of prototype declaration); WDFAPIWrapper.cpp (sample code by explicit DLL linking) |
| DLL Types | DL850E.dll, DL350.dll, DL950.dll, SL2000.dll, XVWDF.dll, DLM3000.dll, DLM3000HD.dll, DLM5000.dll, DLM5000HD.dll |
| Applicable Instruments-DL850E.dll | DL850E series |
| Applicable Instruments-DL350.dll | DL350 |
| Applicable Instruments-DL950.dll | DL950 |
| Applicable Instruments-SL2000.dll | SL2000 |
| Applicable Instruments-XVWDF.dll | Yokogawa's Xviewer software |
| Applicable Instruments-DLM3000.dll | DLM3000 series |
| Applicable Instruments-DLM3000HD.dll | DLM3000HD series |
| Applicable Instruments-DLM5000.dll | DLM5000 series |
| Applicable Instruments-DLM5000HD.dll | DLM5000HD series |
| Main Functions | Getting measuring date/time; getting measuring trace (channel) information; getting measuring points; getting time data/measuring data; getting units of time axis/measuring axis; getting resolutions of time axis/measuring axis |
| Total Number of API Functions | 23 |
| Handle Create/Discard APIs | WdfOpenFileEx |
| Handle Create/Discard APIs | WdfOpenFile |
| Handle Create/Discard APIs | WdfCloseFile |
| Trace Information APIs | WdfGetTraceNumber |
| Trace Information APIs | WdfGetTraceName |
| Trace Information APIs | WdfGetLogicBitName |
| Trace Information APIs | WdfGetTraceBlockNumber |
| Waveform Accompanying Information APIs | WdfGetVDataType |
| Waveform Accompanying Information APIs | WdfGetVOffset |
| Waveform Accompanying Information APIs | WdfGetVResolution |
| Waveform Accompanying Information APIs | WdfIsEnabledVIllegalData |
| Waveform Accompanying Information APIs | WdfGetVIllegalData |
| Waveform Accompanying Information APIs | WdfGetVUnit |
| Waveform Accompanying Information APIs | WdfGetHOffset |
| Waveform Accompanying Information APIs | WdfGetHResolution |
| Waveform Accompanying Information APIs | WdfGetHUnit |
| Waveform Accompanying Information APIs | WdfGetDate |
| Waveform Accompanying Information APIs | WdfGetTime |
| Waveform Data Acquisition APIs | WdfGetBlockSize, WdfGetBlockSize64, WdfGetScaleWave, WdfGetScaleWave64 |
| API Return Type | WDFResult (typedef INT); WDF_OK = 0 (success), other values = error |
| Error Codes (WDFResultKind) | WDF_ERR, WDF_ERR_Error, WDF_ERR_InvalidHandle, WDF_ERR_InvalidParameter, WDF_ERR_Open, WDF_ERR_Alloc, WDF_ERR_FileAccess, WDF_ERR_NotDualCap, WDF_ERR_UnknownVersion, WDF_ERR_UnknownFormat, WDF_ERR_ParamBoundary, WDF_ERR_DataValue, WDF_ERR_CantReadDataType |
| WdfOpenFileEx Format | WDFResult WdfOpenFileEx(WDFHandle* handle, const char* fileName, WDFOpenMode mode) |
| WdfOpenFileEx Return Values | WDF_OK / WDF_ERR_Open / WDF_ERR_Alloc / WDF_ERR_FileAccess / WDF_ERR_UnknownFormat / WDF_ERR_DataValue / WDF_ERR_CantReadDataType |
| Handle Type | WDFHandle (typedef HANDLE) |
| Trace Number Type | WDFTrace (typedef UINT); zero-origin, valid range 0 to N-1 |
| History Block Number Type | WDFHistoryBlock (typedef UINT); 0 = earliest, N-1 = latest |
| Waveform Data Parameter Type | WDFDataParameter (typedef double) |
| Waveform Data Points Type | WDFDataBlock (typedef INT) / WDFDataBlock64 (typedef INT64) |
| Logic Bit Index Type | WDFBitIndex (typedef INT) |
| Open Mode Type | WDFOpenMode (typedef UINT32) |
| Open Mode Values (WDFOpenModeKind) | wdfOpenModeNormal |
| Open Mode Values (WDFOpenModeKind) | wdfOpenModeDualCapture |
| Waveform Data Block Types (WDFVDataType) | wdfDataTypeUINT16, wdfDataTypeSINT16, wdfDataTypeLOGIC16, wdfDataTypeUINT32, wdfDataTypeSINT32, wdfDataTypeLOGIC32, wdfDataTypeFLOAT |
| Acquired Waveform Data Parameter Structure (WDFAccessParam) | version, trace, block, start, count, ppRate, waveType, dataType, cntOut, dst, box, compMode, rsv1-rsv4 |
| Acquired Waveform Data Parameter Structure (WDFAccessParam64) | version, trace, block, start (INT64), count (INT64), ppRate (INT64), waveType, dataType, cntOut (INT64), dst, box, compMode, rsv1-rsv4 |
| Boolean Type | WDFBool (typedef BOOL); TRUE or FALSE |
| Trace Name Buffer Size (MAX_WDF_TRACE_NAME) | 16+1 |
| Logic Bit Name Buffer Size (MAX_WDF_BIT_NAME) | 16+1 |
| Vertical Axis Unit Buffer Size (MAX_WDF_V_UNIT) | 16+1 |
| Horizontal Axis Unit Buffer Size (MAX_WDF_H_UNIT) | 16+1 |
| Date Buffer Size (MAX_WDF_DATE) | 32+1 |
| Time Buffer Size (MAX_WDF_TIME) | 32+1 |
| WdfOpenFileEx Support (DL850E/DL350/DL950/SL2000 DLLs-XVWDF.dll-DLM series DLLs) | Y-Y-N |
| WdfOpenFile Support (DL850E/DL350/DL950/SL2000 DLLs-XVWDF.dll-DLM series DLLs) | N-N-Y |
| 64-bit Waveform API Support (DL850E/DL350/DL950/SL2000 DLLs) | Supported (WdfGetBlockSize64, WdfGetScaleWave64) |
| 64-bit Waveform API Support (XVWDF.dll) | Supported (WdfGetBlockSize64, WdfGetScaleWave64) |
| 64-bit Waveform API Support (DLM3000/DLM3000HD/DLM5000/DLM5000HD DLLs) | Not supported (use WdfGetBlockSize, WdfGetScaleWave) |
| WdfIsEnabledVIllegalData Support | DL850E/DL350/DL950/SL2000 DLLs only (not supported by XVWDF.dll and DLM series DLLs) |
| Large File Support | HD Recording with file divide or >2Gbytes: specify head file (ex. HOGE_000.WDF) |
| Version Compatibility | Cannot load WDF files of newer version than the software |
| Document Number | IM B8074XP-01EN |
| Document Edition | 9th Edition (May 2025) |
Applications
Key Features
Datasheet
Supplier Information
Loading...
Name
Phone
Organization
Use Case

Database Platform