WDF File Access Library

WDF File Access Library

Supplier
Yokogawa
Part Number
WDF File Access Library
Category
Other
Origin
China

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).

Request a Quote Download Datasheet Chat
Save to Favorites Save to Favorites

Overview

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).

Specifications

ParameterValue
Product TypeAPI software library (Dynamic Link Library, DLL)
Supported File FormatWDF (waveform data file saved on Yokogawa measurement instruments)
Supported Operating SystemWindows 10 (32 bit or 64 bit) / Windows 11, English or Japanese version
Application Development EnvironmentVisual Studio 2017 or later
Runtime RequirementVisual Studio 2017 Redistributable Package
LicenseFree 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 TypesDL850E.dll, DL350.dll, DL950.dll, SL2000.dll, XVWDF.dll, DLM3000.dll, DLM3000HD.dll, DLM5000.dll, DLM5000HD.dll
Applicable Instruments-DL850E.dllDL850E series
Applicable Instruments-DL350.dllDL350
Applicable Instruments-DL950.dllDL950
Applicable Instruments-SL2000.dllSL2000
Applicable Instruments-XVWDF.dllYokogawa's Xviewer software
Applicable Instruments-DLM3000.dllDLM3000 series
Applicable Instruments-DLM3000HD.dllDLM3000HD series
Applicable Instruments-DLM5000.dllDLM5000 series
Applicable Instruments-DLM5000HD.dllDLM5000HD series
Main FunctionsGetting 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 Functions23
Handle Create/Discard APIsWdfOpenFileEx
Handle Create/Discard APIsWdfOpenFile
Handle Create/Discard APIsWdfCloseFile
Trace Information APIsWdfGetTraceNumber
Trace Information APIsWdfGetTraceName
Trace Information APIsWdfGetLogicBitName
Trace Information APIsWdfGetTraceBlockNumber
Waveform Accompanying Information APIsWdfGetVDataType
Waveform Accompanying Information APIsWdfGetVOffset
Waveform Accompanying Information APIsWdfGetVResolution
Waveform Accompanying Information APIsWdfIsEnabledVIllegalData
Waveform Accompanying Information APIsWdfGetVIllegalData
Waveform Accompanying Information APIsWdfGetVUnit
Waveform Accompanying Information APIsWdfGetHOffset
Waveform Accompanying Information APIsWdfGetHResolution
Waveform Accompanying Information APIsWdfGetHUnit
Waveform Accompanying Information APIsWdfGetDate
Waveform Accompanying Information APIsWdfGetTime
Waveform Data Acquisition APIsWdfGetBlockSize, WdfGetBlockSize64, WdfGetScaleWave, WdfGetScaleWave64
API Return TypeWDFResult (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 FormatWDFResult WdfOpenFileEx(WDFHandle* handle, const char* fileName, WDFOpenMode mode)
WdfOpenFileEx Return ValuesWDF_OK / WDF_ERR_Open / WDF_ERR_Alloc / WDF_ERR_FileAccess / WDF_ERR_UnknownFormat / WDF_ERR_DataValue / WDF_ERR_CantReadDataType
Handle TypeWDFHandle (typedef HANDLE)
Trace Number TypeWDFTrace (typedef UINT); zero-origin, valid range 0 to N-1
History Block Number TypeWDFHistoryBlock (typedef UINT); 0 = earliest, N-1 = latest
Waveform Data Parameter TypeWDFDataParameter (typedef double)
Waveform Data Points TypeWDFDataBlock (typedef INT) / WDFDataBlock64 (typedef INT64)
Logic Bit Index TypeWDFBitIndex (typedef INT)
Open Mode TypeWDFOpenMode (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 TypeWDFBool (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 SupportDL850E/DL350/DL950/SL2000 DLLs only (not supported by XVWDF.dll and DLM series DLLs)
Large File SupportHD Recording with file divide or >2Gbytes: specify head file (ex. HOGE_000.WDF)
Version CompatibilityCannot load WDF files of newer version than the software
Document NumberIM B8074XP-01EN
Document Edition9th Edition (May 2025)

Applications

1. Development of custom Windows applications that read and analyze waveform data files (.WDF) transferred from Yokogawa oscilloscopes and ScopeCorders to a PC 2. Post-measurement waveform data analysis, processing and graphical display inside user applications 3. Automated extraction of measurement conditions such as measuring date/time, trace names, axis units, offsets and resolutions from recorded WDF files 4. Integration of oscilloscope and ScopeCorder waveform data into third-party test systems, data management and reporting software 5. Review and analysis of long-term recording data in power electronics, mechatronics, automotive and optoelectronics R&D using DL850E/DL950/SL2000 and DLM series data

Key Features

1. Free-of-charge DLL-based API that gives user applications direct access to Yokogawa WDF waveform data files 2. Dedicated DLLs for each instrument family: DL850E series, DL350, DL950, SL2000, Xviewer (XVWDF), DLM3000, DLM3000HD, DLM5000 and DLM5000HD 3. Complete set of 23 API functions covering handle creation/discard, trace (channel) information, vertical/horizontal axis parameters, measuring date/time and raw waveform data readout 4. History waveform support: all history blocks can be accessed with zero-origin block numbering, from the earliest to the latest record 5. Logic module support including logic bit name retrieval (WdfGetLogicBitName) 6. 64-bit data access APIs (WdfGetBlockSize64/WdfGetScaleWave64) for very large waveform records on supported DLLs 7. Easy integration with a prototype declaration header file (WDFAPIPublic.h), DLL import library (.lib) and explicit DLL linking sample code (WDFAPIWrapper.cpp) 8. Runs on Windows 10 (32/64 bit) and Windows 11 with Visual Studio 2017 or later as the development environment

Datasheet

Product Datasheet
PDF
Download

Supplier Information

Yo
Yokogawa
View Supplier →
<p>Yokogawa was founded in 1915 and has more than 6,000 test and measurement instrument patents. It focuses on developing and providing the best test and measurement solutions. Yokogawa Measurement Technology (Shanghai) Co., Ltd. ensures the excellent quality of the brand and contributes to the growth of China's industry.</p>

Request a Quote

Our team responds within 24–48 hours
WDF File Access Library
Yokogawa · Other
Direct from Manufacturer
Your inquiry will be sent directly to the manufacturer
Photonics Source Platform
We handles the inquiry on your behalf
Your information is protected and will never be shared without consent.
Contact Us

Loading...

GetExperimental Plan

Name

Phone

+86

Organization

Use Case

AI Parametric Selection
Smart Match · Precise Recs
Enter Specifications
AI Smart Matching
Get Best Matches
Skip Manual Comparison
Find Best Solutions Fast
Select Now →