DevHelp UnPhysToVirt: Difference between revisions
No edit summary |
No edit summary |
||
(One intermediate revision by the same user not shown) | |||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:DevHelp_UnPhysToVirt}} | {{DISPLAYTITLE:DevHelp_UnPhysToVirt}} | ||
Mark the Completion of Virtual Address Use | |||
This service is required to mark completion of address conversion from PhysToVirt. | This service is required to mark completion of address conversion from PhysToVirt. | ||
==Remarks== | ==Remarks== | ||
This function still exists for compatibility reasons but is no longer operational. | This function still exists for compatibility reasons but is no longer operational. Under OS/2 Warp, UnPhysToVirt exists for compatibility with older drivers. It | ||
can be eliminated from driver which run exclusively under OS/2 Warp. | |||
For OS/2 1.X, UnPhysToVirt must be called by the same procedure that issued the PhysToVirt when the use of converted addresses is completed and before the procedure returns to its caller. The procedure that called PhysToVirt may call other procedures before calling UnPhysToVirt. Multiple PhysToVirt calls may be issued prior to issuing the UnPhysToVirt. Only one call to UnPhysToVirt is needed. | |||
==Example Code== | |||
;C Calling Convention | |||
if (UnPhysToVirt()) error | |||
;C Sample | |||
if (UnPhysToVirt()) | |||
return(RPDONE | RPERR | ERROR_GEN_FAILURE); | |||
[[Category:DevHlps]] | [[Category:DevHlps]] |
Latest revision as of 22:48, 22 May 2025
Mark the Completion of Virtual Address Use
This service is required to mark completion of address conversion from PhysToVirt.
Remarks
This function still exists for compatibility reasons but is no longer operational. Under OS/2 Warp, UnPhysToVirt exists for compatibility with older drivers. It can be eliminated from driver which run exclusively under OS/2 Warp.
For OS/2 1.X, UnPhysToVirt must be called by the same procedure that issued the PhysToVirt when the use of converted addresses is completed and before the procedure returns to its caller. The procedure that called PhysToVirt may call other procedures before calling UnPhysToVirt. Multiple PhysToVirt calls may be issued prior to issuing the UnPhysToVirt. Only one call to UnPhysToVirt is needed.
Example Code
- C Calling Convention
if (UnPhysToVirt()) error
- C Sample
if (UnPhysToVirt()) return(RPDONE | RPERR | ERROR_GEN_FAILURE);