Partager via

OALIoCtlHalDDI (Compact 2013)

  • Article

10/16/2014

This function implements the IOCTL_HAL_DDI code handler used by the OAL flat display driver. OALIoCtlHalDDI retrieves information and sends commands to the Ddi_hflat display driver. The Ddi_hflat driver is a simple display driver that uses a flat framebuffer and the Graphics Primitive Engine (GPE) base class library. For more information, see GPE Base Classes. This function allows you use some of the GPE capabilities within Ddi_hflat without having to work directly with the details of GPE.

Syntax

BOOL OALIoCtlHalDDI(
  UINT32 dwIoControlCode,
  VOID* lpInBuf,
  UINT32 nInBufSize,
  VOID* lpOutBuf,
  UINT32 nOutBufSize,
  UINT32* lpBytesReturned
);

Parameters

  • dwIoControlCode
    [in] Set to IOCTL_HAL_DDI.

  • lpInBuf
    [in] A pointer to an array of ULONG values that describes the command to send to the driver. The following table shows the possible command values.

    Value

    Description

    DDHAL_COMMAND_GET_MODE_INFO

    Returns the size, in bytes, of a display mode, or it returns the data for the display mode. See the Remarks section.

    Set lpInBuf to a two-element array, with this value as first element and the number of the display mode as the second element.

    DDHAL_COMMAND_GET_NUM_MODES

    Returns the number of display modes that the driver supports.

    Set lpInBuf to a pointer to this value.

    DDHAL_COMMAND_POWER

    Turns the driver's power handler on or off.

    Set lpInBuf to a two-element array with this value as the first element and the desired power handler state in the second element. Set the second element to TRUE to turn the power handler on, or FALSE to turn the power handler off.

    DDHAL_COMMAND_SET_MODE

    Sets the display driver's display mode.

    Set lpInBuf to a two-element array with this value as the first element and the number of the new display mode as the second element.

    DDHAL_COMMAND_SET_PALETTE

    Sets the new palette for the display driver.

    Set lpInBuf to a pointer to this value.
  • nInBufSize
    [in] Set to the size, in bytes, of lpInBuf.

  • lpOutBuf
    [in, out] A pointer to a buffer used for either input or output data depending on the type of command passed in lpInBuf. The following table shows the possible values for lpOutBuf.

    Value

    lpOutBuf

    DDHAL_COMMAND_GET_MODE_INFO

    [in] To obtain the size of a display mode, set lpOutBuf to NULL.

    [out] To obtain the data describing a display mode, set lpOutBuf to a pointer to a buffer of UINT8 values. The size of the buffer is the value returned when lpOutBuf is set to NULL.

    DDHAL_COMMAND_GET_NUM_MODES

    [out] A pointer to an int value that will receive the number of display modes.

    DDHAL_COMMAND_POWER

    Set to NULL.

    DDHAL_COMMAND_SET_MODE

    Set to NULL.

    DDHAL_COMMAND_SET_PALETTE

    [in] A buffer of UINT8 values with the data formatted like a DDHAL_SET_PALETTE structure.
  • nOutBufSize
    [in] Set to the size, in bytes, of lpOutBuf.

  • lpBytesReturned
    [out] A pointer to a buffer that receives output data depending on the type of command passed in lpInBuf. The following table shows the possible values for lpBytesReturned.

    Value

    lpBytesReturned

    DDHAL_COMMAND_GET_MODE_INFO

    If lpOutBuf is NULL then this is the number of bytes required to describe a display mode.

    If lpOutBuf is a pointer to a buffer that describes a display mode, then this is the size, in bytes, of the buffer.

    DDHAL_COMMAND_GET_NUM_MODES

    Set to NULL.

    DDHAL_COMMAND_POWER

    Set to NULL.

    DDHAL_COMMAND_SET_MODE

    Set to NULL.

    DDHAL_COMMAND_SET_PALETTE

    Set to NULL.

Return Value

TRUE indicates success.

FALSE indicates failure.

Requirements

Header

oal_ioctl.h

Library

Developer Implemented

See Also

Reference

IOCTL Functions