5.8. WD_Sleep()


	Chapter 5. General WD_xxx Functions

Purpose

Delays execution for a specific duration of time.

Prototype

DWORD WD_Sleep(
    HANDLE hWD,
    WD_SLEEP *pSleep);

Parameters

Description

Name	Description
hWD	Handle to WinDriver's kernel-mode driver as received from `WD_Open`() [5.2]
pSleep	Pointer to a sleep information structure
• dwMicroSeconds	Sleep time in microseconds — 1/1,000,000 of a second
• dwOptions	A bit-mask, which can be set to either of the following values: `Zero (0)` — Busy sleep (default) `SLEEP_NON_BUSY` — Delay execution without consuming CPU resources. Note: This option is applicable only to sleep values larger than 17,000 microseconds. Non-busy sleep is less accurate than busy sleep.

Return Value

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

Remarks

Example usage: to access slow response hardware.

Example

WD_Sleep slp;

BZERO(slp);
slp.dwMicroSeconds = 200;
WD_Sleep(hWD, &slp);


5.7. WD_DebugDump()		5.9. WD_License()