Jump to content

DevHelp ResetTimer: Difference between revisions

From EDM2
Created page with "This service removes a timer handler for the physical device driver. ==Syntax== ===C=== USHORT APIENTRY DevHelp_ResetTimer( NPFN TimerHandler ); ===Assembler=== <PRE> MOV ..."
 
Ak120 (talk | contribs)
mNo edit summary
 
Line 1: Line 1:
This service removes a timer handler for the physical device driver.  
{{DISPLAYTITLE:DevHelp_ResetTimer}}
This service removes a timer handler for the physical device driver.


==Syntax==
==Syntax==
Line 15: Line 16:
==Parameters==
==Parameters==
===C===
===C===
; TimerHandler (NPFN) : Offset to timer handler
;TimerHandler (NPFN): Offset to timer handler
 
===Assembler===
===Assembler===
  MOV  AX,Offset cs:timer_handler    ; Offset to timer handler
  MOV  AX,Offset cs:timer_handler    ; Offset to timer handler
Line 23: Line 25:


Possible errors: Invalid handler if carry flag is set.
Possible errors: Invalid handler if carry flag is set.
===C===


===Assembler===
===Assembler===
Line 39: Line 39:
ResetTimer removes a timer handler from the list of timer handlers. Timer handlers are analogous to the user timer interrupt (INT 1Ch). Refer to TickCount for a discussion of timer handlers.
ResetTimer removes a timer handler from the list of timer handlers. Timer handlers are analogous to the user timer interrupt (INT 1Ch). Refer to TickCount for a discussion of timer handlers.


DS should be set to the data segment of the physical device driver. If the physical device driver issued a call to PhysToVirt referencing the DS register, the physical device driver will restore DS to the original value.  
DS should be set to the data segment of the physical device driver. If the physical device driver issued a call to PhysToVirt referencing the DS register, the physical device driver will restore DS to the original value.


==Example Code==
==Example Code==
Line 48: Line 48:
USHORT APIENTRY DevHelp_ResetTimer( NPFN TimerHandler );
USHORT APIENTRY DevHelp_ResetTimer( NPFN TimerHandler );
</PRE>
</PRE>
==Related Functions==


[[Category:DevHlps]]
[[Category:DevHlps]]

Latest revision as of 14:26, 2 January 2020

This service removes a timer handler for the physical device driver.

Syntax

C

USHORT APIENTRY DevHelp_ResetTimer( NPFN TimerHandler );

Assembler

MOV   AX,Offset cs:timer_handler     ; Offset to timer handler
MOV   DL,DevHlp_ResetTimer

CALL  [Device_Help]

Parameters

C

TimerHandler (NPFN)
Offset to timer handler

Assembler

MOV   AX,Offset cs:timer_handler     ; Offset to timer handler

Return Code

Success Indicator: Clear if successful.

Possible errors: Invalid handler if carry flag is set.

Assembler

'C' Clear if successful.

   'C' Set if error.
       AX = Error code.
            Possible errors:
               Invalid handler if carry flag is set.

Remarks

ResetTimer removes a timer handler from the list of timer handlers. Timer handlers are analogous to the user timer interrupt (INT 1Ch). Refer to TickCount for a discussion of timer handlers.

DS should be set to the data segment of the physical device driver. If the physical device driver issued a call to PhysToVirt referencing the DS register, the physical device driver will restore DS to the original value.

Example Code

C

#include  "dhcalls.h"

USHORT APIENTRY DevHelp_ResetTimer( NPFN TimerHandler );