• Opens a handle to access the WinDriver kernel module. The handle is used by all WinDriver APIs, and therefore must be called before any other WinDriver API is called.

HANDLE WD_Open(void);

The handle to the WinDriver kernel module.
If device could not be opened, returns INVALID_HANDLE_VALUE.

If you are a registered user, please refer to the documentation of WDC_DriverOpen() in the WinDriver PCI Manual, or to the documentation of the low-level WD_License() function in the WinDriver PCI Low-Level API Reference, for an example of how to register your WinDriver license.

HANDLE hWD;

hWD = WD_Open();
if (hWD == INVALID_HANDLE_VALUE)
{
    printf("Cannot open WinDriver device\n");
}

• Returns the version number of the WinDriver kernel module currently running.

DWORD WD_Version(
    HANDLE hWD,
    WD_VERSION *pVer);

Returns WD_STATUS_SUCCESS (0) on success, or an appropriate error code otherwise [A.3].

WD_VERSION ver;

BZERO(ver);
WD_Version(hWD, &ver);
printf("%s\n", ver.cVer);
if (ver.dwVer < WD_VER)
{
    printf("Error - incorrect WinDriver version\n");
}

• Closes the access to the WinDriver kernel module.

void WD_Close(HANDLE hWD);

None

This function must be called when you finish using WinDriver kernel module.

WD_Close(hWD);

• Convenience function for allocating and initializing a PCI Plug-and-Play and power management event structure.

WD_EVENT * DLLCALLCONV PciEventCreate(
    WD_PCI_ID cardId,
    WD_PCI_SLOT pciSlot,
    DWORD dwOptions,
    DWORD dwAction);

Returns a new structure for handling PCI Plug-and-Play and power management events, or NULL if the allocation failed.

It is the responsibility of the caller to free the event structure returned by the function (using free()) when it is no longer needed.

PciEventCreate(cardId, pciSlot, WD_ACKNOWLEDGE, WD_INSERT | WD_REMOVE);

• Convenience function for allocating and initializing a PCMCIA Plug-and-Play and power management event structure.

WD_EVENT * DLLCALLCONV PcmciaEventCreate(
  WD_PCMCIA_ID deviceId,
  WD_PCMCIA_SLOT pcmciaSlot,
  DWORD dwOptions,
  DWORD dwAction);

Returns a new events structure for handling PCMCIA Plug-and-Play and power management events, or NULL if the allocation failed.

It is the responsibility of the caller to free the event structure returned by the function (using free()) when it is no longer needed.

PciEventCreate(deviceId, pcmciaSlot, WD_ACKNOWLEDGE, WD_INSERT | WD_REMOVE);

• Registers your application to receive Plug-and-Play and power management event notifications, according to a predefined set of criteria.
The function receives an event handler callback, which will be invoked upon the occurrence of a registered event.

DWORD EventRegister(
    HANDLE *phEvent,
    HANDLE hWD,
    WD_EVENT *pEvent,
    EVENT_HANDLER pFunc,
    void *pData);

Returns WD_STATUS_SUCCESS (0) on success, or an appropriate error code otherwise [A.3].

This function wraps the low-level WD_EventRegister(), WD_EventPull(), WD_EventSend() and InterruptEnable() functions.

HANDLE *event_handle;
WD_EVENT event;
DWORD dwStatus;
BZERO(event);
event.dwAction = WD_INSERT | WD_REMOVE;
event.dwCardType = WD_BUS_PCI;
dwStatus = EventRegister(&event_handle, hWD, &event,
    event_handler_func, NULL);
if (dwStatus!=WD_STATUS_SUCCESS)
{
    printf("Failed register\n");
    return;
}

• Unregisters from receiving Plug-and-Play and power management event notifications.

DWORD EventUnregister(HANDLE hEvent);

Returns WD_STATUS_SUCCESS (0) on success, or an appropriate error code otherwise [A.3].

This function wraps WD_EventUnregister() and InterruptDisable().

EventUnregister(event_handle);