The DirectDrawCreate function creates an instance of a DirectDraw object.
HRESULT WINAPI DirectDrawCreate(
GUID FAR *lpGUID,
LPDIRECTDRAW FAR *lplpDD,
IUnknown FAR *pUnkOuter
);
Parameters
lpGUID
Address of the globally unique identifier (GUID) that represents the driver to be created. This can be NULL to indicate the active display driver, or you can pass one of the following flags to restrict the active display driver's behavior for debugging purposes:
| DDCREATE_EMULATIONONLY | ||
| The DirectDraw object will use emulation for all features; it will not take advantage of any hardware supported features. | ||
| DDCREATE_HARDWAREONLY | ||
| The DirectDraw object will never emulate features not supported by the hardware. Attempts to call methods that require unsupported features will fail, returning DDERR_UNSUPPORTED. | ||
lplpDD
Address of a pointer that will be initialized with a valid DirectDraw pointer if the call succeeds.
pUnkOuter
Allows for future compatibility with COM aggregation features. Presently, however, DirectDrawCreate returns an error if this parameter is anything but NULL.
Return Values
If the function succeeds, the return value is DD_OK.
If the function fails, the return value may be one of the following error values:
| DDERR_DIRECTDRAWALREADYCREATED |
| DDERR_GENERIC |
| DDERR_INVALIDDIRECTDRAWGUID |
| DDERR_INVALIDPARAMS |
| DDERR_NODIRECTDRAWHW |
| DDERR_OUTOFMEMORY |
Remarks
This function attempts to initialize a DirectDraw object, and it then sets a pointer to the object if the call is successful.
On systems with multiple monitors, specifying NULL for lpGUID causes the DirectDraw object to run in emulation mode when the normal cooperative level is set. To make use of hardware acceleration on these systems, you must specify the device's GUID. For more information, see Devices and Acceleration in MultiMon Systems.
QuickInfo
Windows NT: Use version 4.0 or later.
Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in ddraw.h.
Import Library: Use ddraw.lib.