## Input/Output Device Driver Reference

[prev][next][parent][TOC]

### Description of Test Cases

Each of the APM IOCtl test cases can be executed individually as previously described. The corresponding test scripts are described below. The user can create additional tests or combine tests into logically organized test groups to test certain aspects of the driver, after becoming familiar with the DDTT and the APM IOCtl grammar files.

All of the APM IOCtl test cases use the DDTT @IMPORT command to include APM _RET.SCR which contains the return codes from the IOCtl calls.

All test scripts close the APM device driver and verify successful status return from every exercised API. All test scripts log information to a log file with the same file name and a file name extension, .LOG. The same information is also written to DDTT's output windows. Log files can be examined after the test case has completed.

APM_RET.SCR A common script included by all scripts that contains the error codes returned by the IOCtl calls.

ENABLE01.SCR Enables power management functions for BIOS-managed devices.

ENABLE0.SCR Enables power management functions for system BIOS.

ENABLE1.SCR Enables power management functions for display devices.

ENABLE2.SCR Enables power management functions for secondary storage devices.

ENABLE3.SCR Enables power management functions for parallel ports.

ENABLE4.SCR Enables power management functions for serial ports.

ENABLE6.SCR Enables power management functions for PCMCIA sockets.

DISABL01.SCR Disables power management functions for BIOS-managed devices.

DISABLE0.SCR Disables power management functions for system BIOS.

DISABLE1.SCR Disables power management functions for display devices.

DISABLE2.SCR Disables power management functions for secondary storage devices.

DISABLE3.SCR Disables power management functions for parallel ports.

DISABLE4.SCR Disables power management functions for serial ports.

DISABLE6.SCR Disables power management functions for PCMCIA sockets.

ENGAGE01.SCR Engages power management functions so that cooperative power management between BIOS and the operating system takes place for the BIOS- managed devices.

ENGAGE0.SCR Engages power management functions so that cooperative power management between BIOS and the operating system takes place for the system BIOS.

ENGAGE1.SCR Engages power management functions so that cooperative power management between BIOS and the operating system takes place for the display devices.

ENGAGE2.SCR Engages power management functions so that cooperative power management between BIOS and the operating system takes place for the secondary storage devices.

ENGAGE3.SCR Engages power management functions so that cooperative power management between BIOS and the operating system takes place for parallel ports.

ENGAGE4.SCR Engages power management functions so that cooperative power management between BIOS and the operating system takes place for serial ports.

ENGAGE6.SCR Engages power management functions so that cooperative power management between BIOS and the operating system takes place for the PCMCIA sockets.

DISENG01.SCR Disengages power management functions therefore BIOS will be automatically performing power management without operating system cooperation for all BIOS-managed devices.

DISENG0.SCR Disengages power management functions therefore BIOS will be automatically performing power management without operating system cooperation for itself.

DISENG1.SCR Disengages power management functions therefore BIOS will be automatically performing power management without operating system cooperation for display devices.

DISENG2.SCR Disengages power management functions therefore BIOS will be automatically performing power management without operating system cooperation for secondary storage devices.

DISENG3.SCR Disengages power management functions therefore BIOS will be automatically performing power management without operating system cooperation for parallel ports.

DISENG4.SCR Disengages power management functions therefore BIOS will be automatically performing power management without operating system cooperation for serial ports.

DISENG6.SCR Disengages power management functions therefore BIOS will be automatically performing power management without operating system cooperation for PCMCIA sockets.

RESTORE.SCR Restores the BIOS defaults.

SBMDOFF.SCR Sets the power of system BIOS-managed devices to off.

SBMDRDY.SCR Sets the power of system BIOS-managed devices to ready.

SBMDSBY.SCR Sets the power of system BIOS-managed devices to standby.

SBMDSPD.SCR Sets the power of system BIOS-managed devices to suspend.

SBIOSOFF.SCR Sets the power of the system BIOS to off.

SBIOSRDY.SCR Sets the power of the system BIOS to ready.

SBIOSSBY.SCR Sets the power of the system BIOS to standby.

SBIOSSPD.SCR Sets the power of the system BIOS to suspend.

SDSPLOFF.SCR Sets the power of display devices to off.

SDSPLRDY.SCR Sets the power of display devices to ready.

SDSPLSBY.SCR Sets the power of display devices to standby.

SDSPLSPD.SCR Sets the power of Display Devices to suspend.

SSTGOFF.SCR Sets the power of secondary storage devices to off.

SSTGRDY.SCR Sets the power of secondary storage devices to ready.

SSTGSBY.SCR Sets the power of secondary storage devices to standby.

SSTGSPD.SCR Sets the power of secondary storage devices to suspend.

SPPRTOFF.SCR Sets the power of parallel ports to off.

SPPRTRDY.SCR Sets the power of parallel ports to ready.

SPPRTSBY.SCR Sets the power of parallel ports to standby.

SPPRTSPD.SCR Sets the power of parallel ports to suspend.

SSPRTOFF.SCR Sets the power of serial ports to off.

SSPRTRDY.SCR Sets the power of serial ports to ready.

SSPRTSBY.SCR Sets the power of serial ports to standby.

SSPRTSPD.SCR Sets the power of serial ports to suspend.

SPCMCOFF.SCR Sets the power of PCMCIA sockets to off.

SPCMCRDY.SCR Sets the power of PCMCIA sockets to ready.

SPCMCSBY.SCR Sets the power of PCMCIA sockets to standby.

SPCMCSPD.SCR Sets the power of PCMCIA sockets to suspend.

41ERROR1.SCR Error case. Attempts to set up a semaphore without providing a semaphore type.

41ERROR2.SCR Error case. Requests a semaphore setup and removal at the same time.

41ERROR3.SCR Error case. Attempts to set up both a 32-bit and 16-bit semaphore at the same time.

41ERROR4.SCR Error case. Attempts to set up a semaphore while NoSemFlag is set.

41ERROR5.SCR Error case. Attempts to set up a semaphore despite the case that there already exists one.

41ERROR6.SCR Error case. Bad semaphore handle.

41ERROR7.SCR Error case. Attempts to remove a semaphore which was not set up.

41ERROR8.SCR Error case. An invalid event mask is used while setting the resource set.

41SEMREM.SCR Removes an already set up semaphore.

QPOWEN01.SCR Returns the enable power management event information queued in the Power Management Services subsystem for system BIOS-managed devices (semaphore implementation).

QPOWEEN0.SCR Returns the enable power management event information queued in the Power Management Services subsystem for system BIOS (semaphore implementation).

QPOWEEN1.SCR Returns the enable power management event information queued in the Power Management Services subsystem for display devices (semaphore implementation).

QPOWEEN2.SCR Returns the enable power management event information queued in the Power Management Services subsystem for secondary storage devices ( semaphore implementation).

QPOWEEN3.SCR Returns the enable power management event information queued in the Power Management Services subsystem for parallel ports (semaphore implementation).

QPOWEEN4.SCR Returns the enable power management event information queued in the Power Management Services subsystem for serial ports (semaphore implementation).

QPOWEEN6.SCR Returns the enable power management event information queued in the Power Management Services subsystem for PCMCIA Sockets (semaphore implementation).

QPWDIS01.SCR Returns the disable power management event information queued in the Power Management Services subsystem for system BIOS-managed device drivers (semaphore implementation).

QPOWDIS0.SCR Returns the disable power management event information queued in the Power Management Services subsystem for system BIOS (semaphore implementation).

QPOWDIS1.SCR Returns the disable power management event information queued in the Power Management Services subsystem for display devices (semaphore implementation).

QPOWDIS2.SCR Returns the disable power management event information queued in the Power Management Services subsystem for secondary storage devices ( semaphore implementation).

QPOWDIS3.SCR Returns the disable power management event information queued in the Power Management Services subsystem for parallel ports (semaphore implementation).

QPOWDIS4.SCR Returns the disable power management event information queued in the Power Management Services subsystem for serial ports (semaphore implementation).

QPOWDIS6.SCR Returns the disable power management event information queued in the Power Management Services subsystem for PCMCIA sockets (semaphore implementation).

QPWENG01.SCR Returns the engage power management event information queued in the Power Management Services subsystem for System BIOS-managed devices (semaphore implementation).

QPOWENG0.SCR Returns the engage power management event information queued in the Power Management Services subsystem for system BIOS (semaphore implementation).

QPOWENG1.SCR Returns the engage power management event information queued in the Power Management Services subsystem for display devices (semaphore implementation).

QPOWENG2.SCR Returns the engage power management event information queued in the Power Management Services subsystem for secondary storage devices ( semaphore implementation).

QPOWENG3.SCR Returns the engage power management event information queued in the Power Management Services subsystem for parallel ports (semaphore implementation).

QPOWENG4.SCR Returns the engage power management event information queued in the Power Management Services subsystem for serial ports (semaphore implementation).

QPOWENG6.SCR Returns the engage power management event information queued in the Power Management Services subsystem for PCMCIA sockets (semaphore implementation).

QPWDSE01.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for system BIOS-managed devices (semaphore implementation).

QPWDSEN0.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for system BIOS ( semaphore implementation).

QPWDSEN1.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for display devices ( semaphore implementation).

QPWDSEN2.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for secondary storage devices (semaphore implementation).

QPWDSEN3.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for parallel ports ( semaphore implementation).

QPWDSEN4.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for serial ports ( semaphore implementation).

QPWDSEN6.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for PCMCIA sockets ( semaphore implementation).

QPWENS01.SCR Returns the enable power management event information queued in the Power Management Services subsystem for system BIOS-managed devices (non-semaphore implementation).

QPWENNS0.SCR Returns the enable power management event information queued in the Power Management Services subsystem for system BIOS (non-semaphore implementation).

QPWENNS1.SCR Returns the enable power management event information queued in the Power Management Services subsystem for display devices (non- semaphore implementation).

QPWENNS2.SCR Returns the enable power management event information queued in the Power Management Services subsystem for secondary storage devices ( non-semaphore implementation).

QPWENNS3.SCR Returns the enable power management event information queued in the Power Management Services subsystem for parallel ports (non- semaphore implementation).

QPWENNS4.SCR Returns the enable power management event information queued in the Power Management Services subsystem for serial ports (non-semaphore implementation).

QPWENNS6.SCR Returns the enable power management event information queued in the Power Management Services subsystem for PCMCIA sockets (non- semaphore implementation).

QPDSNS01.SCR Returns the disable power management event information queued in the Power Management Services subsystem for system BIOS-managed devices (non-semaphore implementation).

QPWDSNS0.SCR Returns the disable power management event information queued in the Power Management Services subsystem for system BIOS (non-semaphore implementation).

QPWDSNS1.SCR Returns the disable power management event information queued in the Power Management Services subsystem for display devices (non- semaphore implementation).

QPWDSNS2.SCR Returns the disable power management event information queued in the Power Management Services subsystem for secondary storage devices ( non-semaphore implementation).

QPWDSNS3.SCR Returns the disable power management event information queued in the Power Management Services subsystem for parallel ports (non- semaphore implementation).

QPWDSNS4.SCR Returns the disable power management event information queued in the Power Management Services subsystem for serial ports (non-semaphore implementation).

QPWDSNS6.SCR Returns the disable power management event information queued in the Power Management Services subsystem for PCMCIA sockets (non- semaphore implementation).

QPEGNS01.SCR Returns the engage power management event information queued in the Power Management Services subsystem for system BIOS-managed devices (non-semaphore implementation).

QPENGNS0.SCR Returns the engage power management event information queued in the Power Management Services subsystem for system BIOS (non-semaphore implememtation).

QPENGNS1.SCR Returns the engage power management event information queued in the Power Management Services subsystem for display devices (non- semaphore implementation).

QPENGNS2.SCR Returns the engage power management event information queued in the Power Management Services subsystem for secondary storage devices ( non-semaphore implementation)

QPENGNS3.SCR Returns the engage power management event information queued in the Power Management Services subsystem for parallel ports (non- semaphore implementation).

QPENGNS4.SCR Returns the engage power management event information queued in the Power Management Services subsystem for serial ports (non-semaphore implementation)

QPENGNS6.SCR Returns the engage power management event information queued in the Power Management Services subsystem for PCMCIA sockets (non- semaphore implementation).

QPDGNS01.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for system BIOS-managed devices (non-semaphore implementation).

QPDSGNS0.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for system BIOS (non- semaphore implementation).

QPDSGNS1.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for system BIOS-managed devices (non-semaphore implementation).

QPDSGNS2.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for secondary storage devices (non-semaphore implementation).

QPDSGNS3.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for parallel ports (non- semaphore implementation).

QPDSGNS4.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for serial ports (non- semaphore implementation).

QPDSGNS6.SCR Returns the disengage power management event information queued in the Power Management Services subsystem for PCMCIA sockets (non- semaphore implementation).

QP01SE.SCR Queries the power state of system BIOS-managed devices using semaphores for event notification.

QP0SE.SCR Queries the power state of system BIOS using semaphores for event notification.

QP1SE.SCR Queries the power state of display devices using semaphores for event notification.

QP2SE.SCR Queries the power state of secondary storage devices using semaphores for event notification.

QP3SE.SCR Queries the power state of parallel ports using semaphores for event notification.

QP4SE.SCR Queries the power state of serial ports using semaphores for event notification.

QP6SE.SCR Queries the power state of PCMCIA sockets using semaphores for event notification.

QP01NS.SCR Queries the power state of system BIOS-managed devices without using semaphores.

QP0NS.SCR Queries the power state of system BIOS without using semaphores.

QP1NS.SCR Queries the power state of display devices devices without using semaphores.

QP2NS.SCR Queries the power state of secondary storage devices without using semaphores.

QP3NS.SCR Queries the power state of parallel ports without using semaphores.

QP4NS.SCR Queries the power state of serial ports without using semaphores.

QP6NS.SCR Queries the power state of PCMCIA sockets without using semaphores.

QPOWINFO.SCR Returns the Power Management subsystem and BIOS configuration information.

QPOWSTAT.SCR Returns the current power state information for the system and system devices.

QPWSTE01.SCR Returns the current power state of system BIOS-managed devices .

QPOWSTE0.SCR Returns the current power state of system BIOS.

QPOWSTE1.SCR Returns the current power state of display devices.

QPOWSTE2.SCR Returns the current power state of secondary storage devices.

QPOWSTE3.SCR Returns the current power state of parallel ports.

QPOWSTE4.SCR Returns the current power state of serial ports.

QPOWSTE6.SCR Returns the current power state of PCMCIA sockets.

RBIOSDNS.SCR Returns the Restore BIOS defaults event information queued in the Power Management Services Subsystem (non-semaphore implementation).

RBIOSDSE.SCR Returns the Restore BIOS defaults event information queued in the Power Management Services Subsystem (semaphore implementation).

SINIDOFF.SCR Handles the error case in which the power of an invalid device is attempted to be set to off.

SINSTAT1.SCR Attempts to set the power of a valid device to an invalid power state.

SINVSTAT.SCR Attempts to set the power of an invalid device to an invalid power state.