IDirectDraw7 introduces improved compliance with COM rules that dictate the lifetime of child objects. Wherever an IDirectDraw2 interface method might accept a DDSURFACEDESC structure and retrieve an IDirectDrawSurface3 interface, the methods in IDirectDraw7 accept a DDSURFACEDESC2 structure and retrieve an IDirectDrawSurface7 interface, instead. All the surface-related methods in the IDirectDraw7 interface accept slightly different parameters than their counterparts in the IDirectDraw2 interface. The IDirectDraw7 interface extends the features of previous versions of the interface by offering methods that enable more flexible surface management than previous versions. SetCooperativeLevel and TestCooperativeLevelĬreateClipper, CreatePalette, and CreateSurface The methods of the IDirectDraw7 interface can be organized into the following groups: Group Helps the application synchronize itself with the vertical-blank interval. Reports the current cooperative-level status of the DirectDraw device for a windowed or full-screen application.
Initiates a test to update the system registry with refresh rate information for the current display adapter and monitor combination. Sets the mode of the display-device hardware. Exclusive-level access is required to use this method.ĭetermines the top-level behavior of the application. Resets the mode of the display device hardware for the primary surface to what it was before the IDirectDraw7::SetDisplayMode method was called. Restores all the surfaces that were created for the DirectDraw object, in the order that they were created. Initializes a DirectDraw object that was created by using the CoCreateInstance COM function. Retrieves the status of the vertical blank. Retrieves the IDirectDrawSurface7 interface for a surface, based on its GDI device context handle.
Retrieves the scan line that is currently being drawn on the monitor. Retrieves the frequency of the monitor that the DirectDraw object controls. Retrieves the DirectDrawSurface object that currently represents the surface memory that GDI is treating as the primary surface. This method can also retrieve the number of codes that are supported. Retrieves the four-character codes (FOURCC) that are supported by the DirectDraw object.
This method can be used, with caution, to recognize specific hardware installations to implement workarounds for poor driver or chipset behavior. Obtains information about the device driver. Retrieves the capabilities of the device driver for the hardware and the hardware emulation layer (HEL).
Retrieves the total amount of display memory available and the amount of display memory currently free for a given type of surface. Makes the surface that the GDI writes to the primary surface. Used after a call to IDirectDraw7::StartModeTest to pass or fail each mode that the test presents and to step through the modes until the test is complete. This method is not currently implemented.Ĭreates a DirectDrawPalette object for this DirectDraw object.Ĭreates a DirectDrawSurface object for this DirectDraw object.Įnumerates all the display modes that the hardware exposes through the DirectDraw object and that are compatible with a provided surface description.Įnumerates all the existing or possible surfaces that meet the specified surface description.
The IDirectDraw7 interface has these methods. IDirectDraw7 also has these types of members: Methods The IDirectDraw7 interface inherits from the IUnknown interface. This section is a reference to the methods of the IDirectDraw7 interface. Applications use the methods of the IDirectDraw7 interface to create DirectDraw objects and work with system-level variables.