DisablePhysicalDeviceBlock

OS2_PM_DRV_ENABLE: DisablePhysicalDeviceBlock is called by the system to disable the specified device and to free any associated memory.

Syntax
DisablePhysicalDeviceBlock(ulSubfunction, ulParam1, pParam2);

Parameters

 * ulSubfunction (ULONG) - input
 * 04H.


 * ulParam1 (ULONG) - input
 * A handle or pointer, ulStateInfo, to physical device block.


 * pParam2 (PLONG) - input
 * Not used.

Return Code

 * rc (LONG) - returns
 * Return codes.


 * The handling routine should return a LONG integer. Valid values are:
 * 0 Successful
 * -1 Error

Remarks
Presentation drivers for the primary display device return a value of 0 (zero) without taking any action.


 * Note: The operating system never calls this subfunction in the hardcopy driver if the driver uses one physical device block to support multiple device contexts. Presentation drivers notify the operating system of this capability by not setting bit 0 of the Logical Device flags returned to the system from the FillLogicalDeviceBlock subroutine.

Sample Code

 * 1) include 

ULONG   ulSubfunction;  /*  04H. */ ULONG   ulParam1; PLONG   pParam2;        /*  Not used. */ LONG    rc;             /*  Return codes. */

rc = DisablePhysicalDeviceBlock(ulSubfunction,      ulParam1, pParam2);

