no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
Last revision | |||
— | en:ibm:prcp:vio:modewait [2016/09/15 05:51] – created valerius | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ==== VioModeWait ==== | ||
+ | |||
+ | **Bindings**: | ||
+ | |||
+ | This call allows a graphics mode application to be notified when it must restore its video mode, state, and modified display adapter registers. The return from this function call provides the notification. | ||
+ | |||
+ | // | ||
+ | |||
+ | // | ||
+ | Application request event. RequestType = 0 indicates the application wants to be notified at the end of a pop-up to restore its mode. RequestType = 0 is the only event supported by [[modewait|VioModeWait]]. | ||
+ | |||
+ | // | ||
+ | Address of the operation to be performed by the application returning from [[|modewait|VioModeWait]]. // | ||
+ | |||
+ | // | ||
+ | Reserved word of 0s. | ||
+ | |||
+ | //rc// (**USHORT**) - return | ||
+ | Return code descriptions are: | ||
+ | |||
+ | |0 |NO_ERROR | | ||
+ | |421 |ERROR_VIO_INVALID_PARMS | | ||
+ | |422 |ERROR_VIO_FUNCTION_OWNED | | ||
+ | |423 |ERROR_VIO_RETURN | | ||
+ | |424 |ERROR_SCS_INVALID_FUNCTION | | ||
+ | |428 |ERROR_VIO_NO_SAVE_RESTORE_THD | | ||
+ | |430 |ERROR_VIO_ILLEGAL_DURING_POPUP | | ||
+ | |465 |ERROR_VIO_DETACHED | | ||
+ | |494 |ERROR_VIO_EXTENDED_SG | | ||
+ | |||
+ | **Remarks** | ||
+ | |||
+ | At the completion of an application or hard error pop-up (reference [[popup|VioPopUp]]), | ||
+ | |||
+ | When an application' | ||
+ | |||
+ | Only one process for a session can issue [[modewait|VioModeWait]]. The first process that issues [[modewait|VioModeWait]] becomes the owner of this function. (Refer to [[modeundo|VioModeUndo]].) | ||
+ | |||
+ | An application must issue [[modewait|VioModeWait]] only if it writes directly to the registers on the display adapter. Otherwise, the application can allow OS/2 to perform the required restore by not issuing [[modewait|VioModeWait]]. | ||
+ | |||
+ | When an application issues [[modewait|VioModeWait]], | ||
+ | |||
+ | === C bindings === | ||
+ | |||
+ | <code c> | ||
+ | #define INCL_VIO | ||
+ | |||
+ | USHORT | ||
+ | |||
+ | USHORT | ||
+ | PUSHORT | ||
+ | USHORT | ||
+ | |||
+ | USHORT | ||
+ | </ | ||
+ | |||
+ | === MASM bindings === | ||
+ | |||
+ | <code asm> | ||
+ | EXTRN VioModeWait: | ||
+ | INCL_VIO | ||
+ | |||
+ | PUSH | ||
+ | PUSH@ WORD NotifyType | ||
+ | PUSH | ||
+ | CALL | ||
+ | |||
+ | Returns WORD | ||
+ | </ | ||