Bagikan melalui


IViewHelper::SetConfiguration method

The SetConfiguration method passes in display data (display modes and topology data) to the underlying user-mode display driver that the driver should set.

Syntax

HRESULT SetConfiguration(
  [in, optional] IStream *pIStream,
  [out]          ULONG   *pulStatus
);

Parameters

  • pIStream [in, optional]
    [in] A pointer to an IStream interface. The IStream object contains display modes and topology data that are formatted by using the data structures in the Cloneviewhelper.h header file. When the Release method of IStream is called, the memory that backs the IStream is freed. TMM will call Release on the IStream interface pointer if SetConfiguration returns an error result. Otherwise, the user-mode display driver should call Release. Release is called to free the memory that was allocated to store the view information. For more information about IStream, see the Microsoft Windows SDK documentation.

  • pulStatus [out]
    [out] A pointer to a ULONG that receives the driver's status after the driver performs the configuration that TMM passed in. The status can be set to one of the following values.

    Value Meaning
    SETCONFIGURATION_STATUS_APPLIED (0) The driver applied the configuration that TMM passed in.
    SETCONFIGURATION_STATUS_ADDITIONAL (1) The driver applied the configuration that TMM passed in along with additional proprietary hardware-vendor settings.
    SETCONFIGURATION_STATUS_OVERRIDDEN (2) The driver overrode the configuration that TMM passed in and applied proprietary hardware-vendor settings.

     

Return value

The SetConfiguration method returns one of the following values:

Return code Description
S_OK

SetConfiguration successfully set up display data.

E_POINTER

The pIStream parameter is set to NULL.

E_ABORT

The driver failed to apply settings. In this situation, TMM will resume control and apply settings through a call to the Win32 ChangeDisplaySettingsEx function and the IViewHelper::SetActiveTopology method. For more information about ChangeDisplaySettingsEx, see the Windows SDK documentation.

 

Remarks

After SetConfiguration passes display data to the underlying user-mode display driver, the driver can modify or fold in new data before setting the display.

SetConfiguration is called when TMM must change the display settings and topology to match a known state that was last recorded by TMM.

The following data structures are used to format the display modes and topology data that the IStream object that the pIStream parameter points to contains:

These structures are defined in the Cloneviewhelper.h.

Requirements

End of support

Windows 7

Header

Cloneviewhelper.h (include Cloneviewhelper.h)

See also

Adapter

Adapters

DisplayMode

DisplayModes

IViewHelper::SetActiveTopology

Sources

 

 

Send comments about this topic to Microsoft