pm_register_planar_control_handle Kernel Service

Purpose

Registers and unregisters a planar control subroutine.

Syntax

#include <sys/pm.h>
int pm_register_planar_control_handle(ppch, command)
struct pm_planar_control_handle *ppch;
int command;

Parameters

ppch        Points a 
pm_planar_control_handle structure as follows.
            The structure and the control subroutine must be pinned.
 
struct pm_planar_control_handle {
            int              DevID;
            int              (*control)(dev_t DevNumber, int DevID,
int command);
             struct pm_planar_control_handle          *next;
 
command      Specifies one of the following:
             PM_REGISTER
             PM_UNREGISTER

Description

The pm_register_planar_control_handle kernel service registers and unregisters planar control subroutines.

The planar device ID, DevID, are stored in the ODM. The Power Management aware device driver retrieves the values at device configuration if planar_control operation is required to control the low power or off state of its own device on the planar as follows:

• Display indicator

  LCD	PMDEV_LCD	0x00010000
  CRT	PMDEV_CRT	0x00010100

• Video Controller

  Graphic controller	PMDEV_GCC	0x00020000
  DAC	PMDEV_DAC	0x00020100
  VRAM	PMDEV_VRAM	0x00020200

• Multi media

  Video capture	PMDEV_VCAP	0x00030000
  Playback	PMDEV_VPLAY	0x00030100
  CCD camera	PMDEV_CAMERA	0x00030200
  Audio	PMDEV_AUDIO	0x00030300

• Graphical input

  Internal keyboard	PMDEV_INTKBD	0x00040000
  External keyboard	PMDEV_EXTKBD	0x00040100
  Internal mouse	PMDEV_INTMOUSE	0x00040200
  External mouse	PMDEV_EXTMOUSE	0x00040300

• Communication device

  Serial	PMDEV_SERIAL	0x00050000
  Parallell	PMDEV_PARALLEL	0x00050100

• SCSI adapter

  SCSI controller	PMDEV_SCSIC	0x00060000
  SCSI bus terminator	PMDEV_SCSIT	0x00060100

• Internal SCSI device

  Device ID 0-6

  PMDEV_SCSIn(n=0-6)

  0x00070000-0x00070600

• Internal IDE device

  Device ID 0-3

  PMDEV_IDEn(n=0-3)

  0x00080000-0x00080300

• CPU local bus

  CPU	PMDEV_CPU	0x00090000
  L2 cache	PMDEV_L2	0x00090100
  Others	PMDEV_LOCALn(n=2-f)	0x00090200-0x00090f00

• Extended bus slot

  ISA bus slot 0-f	PMDEV_ISAn(n=0-f)		0x000a0000-0x000a000f
  Micro Channel slot 0-f	PMDEV_MCAn(n=0-f)		0x000a0100-0x000a010f
  PCI slot 0-f	PMDEV_PCIn(n=0-f)		0x000a0200-0x000a020f
  PCMCIA slot 0-f	PMDEV_PCMCIAn(n=0-f)		0x000a0300-0x000a030f

• Power supply unit (PSU)

  Suspend power	PMDEV_PSUSUS	0x000b0000
  Main power	PMDEV_PSUMAIN	0x000b0100

• Others

  FDD/FDC	PMDEV_FDD	0x000f0000
  Internal CD-ROM	PMDEV_CDROM	0x000f0100

Return Values

Implementation Specifics

The pm_register_planar_control_handle kernel service is part of the Base Operating System (BOS) Runtime.

Related Information

The pm_planar_control kernel service.