DioGetFrequency

Applies To

GC5050, GX5050, GX5055, GX5150, GX5280, GX5290, GX5290e, GX5295, File

Purpose

Returns the current programmed frequency.

Syntax

DioGetFrequency (nMasterHandle, pdwFrequency, pnStatus)

Parameters

Name	Type	Comments
nMasterHandle	SHORT	Master or File board handle.
pdwFrequency	PDWORD	Return frequency range. GC5050: 5Hz to 60MHz. GX5050: 5Hz to 60MHz. GX5055: 5Hz to 50MHz. GX5150: 5Hz to 60MHz. GX5281: 5Hz to 50MHz. GX5282: 5Hz to 100MHz. GX5283: 5Hz to 200MHz. GX5291: 5Hz to 100MHz. GX5292: 5Hz to 100MHz. GX5293: 5Hz to 200MHz. GX5291e: 5Hz to 100MHz. GX5292e: 5Hz to 100MHz. GX5293e: 5Hz to 200MHz. GX5295: 5Hz to 100MHz.
pnStatus	PSHORT	Returned status: 0 on success, negative number on failure.

Comments

GX5150:

After calling DioReset or power up, the internal clock is set to 10 MHz.

GC5050, GX5050, GX5055, GX5280, GX5290, GX5290e, GX5295:

After calling DioReset or power up, the internal clock is set to 10 MHz.

GX5293/GX5293e: for frequencies above 100MHz the user must set the number of active I/O channels (wide) to be 16 or less, see the DioSetupIOConfiguration function for more details.

GX5283/GX5293/GX5293e: for frequencies above 100MHz all clock and strobe delays have to be between 0 and 3nSec, see DioSetupClkStrobeDelay function for more details.

GX5293/GX5293e: for frequencies above 100MHz the user must set the number of active I/O channels (wide) to be 16 or less, see the DioSetupIOConfiguration function for more details.

Note: using driver v4.0 (Build 48) and above frequency can be set regardless of the board's state (PAUSE/HALT/RUN).

Example

The following example returns the frequency value from a Master board specified by the board handle:

SHORT nStatus;

DWORD dwFrequency;

DioGetFrequency(nMasterHandle, &dwFrequency, &nStatus);