Microsoft SDK for Java

createDeviceFromClipper

This method of the Direct3dRM Class creates a Microsoft® Direct3DRM windows device by using a specified DirectDrawClipper object.

Syntax

public Direct3dRMDevice createDeviceFromClipper( DirectDrawClipper lpDDClipper, _Guid g, int width, int height);

Return Value

Returns the Direct3dRMDevice object if successful; otherwise, null.

Parameters

lpDDrawClipper A DirectDrawClipper object.
g A globally unique identifier (GUID). This parameter can be null.
width The width of the device to be created.
height The height of the device to be created.

Remarks

If the g parameter is null, the system searches for a device with a default set of device capabilities. This is the recommended way to create a Retained-Mode device because it always works, even if the user installs new hardware.

If a hardware device is not found, the monochromatic (ramp) software driver is loaded. An application should enumerate devices instead of specifying null for g if it has special needs that are not met by default settings.

If you are having palette problems using this method, try using the createDeviceFromD3D as an alternative.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.