Description for iowkit.dll - Code Mercenaries

IO-Warrior Dynamic Library
for Windows V1.5
Code Mercenaries
IowKitReadImmediate
Declaration:
BOOL IOWKIT_API IowKitReadImmediate(IOWKIT_HANDLE devHandle, PDWORD value);
function IowKitReadImmediate(devHandle: IOWKIT_HANDLE; var value: DWORD): BOOL; stdcall;
Return current value directly read from the IO-Warrior I/O pins.
The function returns TRUE if a new value has arrived otherwise it returns FALSE and places the last
value read into value.
The function can only read the I/O pins so it does not need a numPipe parameter. It also abstracts from the
number of I/O pins the device has. It always returns 32 bits as a DWORD. For the IOWarrior24 which has only
16 I/O pins the upper WORD of the DWORD is set to 0.
The function internally uses the Special Mode Function „Read current pin status“ if available. For chip
revisions predating revision 1.0.1.0 it returns the most recent value read from the IO-Pins or returns FALSE if no
value has been read yet.
The 1.4 version of the API implements another strategy. That strategy is now available through
IowKitReadNonBlocking. 1.5 reverts to the implementation of the 1.2 API to provide compatibility.
This function fails unconditionally for IOW56 devices because it cannot handle more than 32 bits. For the
IOW56 you can always use the special mode function „Get Current Pin Status“ directly instead.
Sample usage C:
DWORD bits;
if (IowKitReadImmediate(ioHandle, &bits))
{
// new data from IO-Warrior pins
...
}
Sample usage Delphi:
var
Bits: DWORD;
begin
if IowKitReadImmediate(ioHandle, Bits) then
begin
// new data from IO-Warrior pins
...
end;
IO-Warrior Dynamic Library V1.5 8. Dez 2005 14