Share via

D3DHAL_CONTEXTCREATEDATA

  • Article

This structure contains all of the information that D3dContextCreate needs to create a new context.

typedef struct _D3DHAL_CONTEXTCREATEDATA {
  PDD_DIRECTDRAW_LOCAL  lpDDLcl;
  PDD_SURFACE_LOCAL lpDDSLcl;
  PDD_SURFACE_LOCAL lpDDSZLcl;
  DWORD dwPID;
  ULONG_PTR dwhContext;
  HRESULT ddrval;
} D3DHAL_CONTEXTCREATEDATA, *LPD3DHAL_CONTEXTCREATEDATA;

Members

  • lpDDLcl
    Points to the Microsoft DirectDraw® object that an application must create in order to retrieve the COM Interface to Direct3D. This allows context information to be shared between a DirectDraw application and the driver. lpDDLcl is the common and binding factor between the application's context and the driver's context. It points to a DDRAWI_DIRECTDRAW_LCL structure that is used to identify the surfaces that belong to a given Direct3D context and is relevant to the current DirectDraw process only. lpDDLcl is necessary because surfaces (for example, depth buffers, rendering buffers, and textures) can be created before a Direct3D context is ever created in the driver.
  • lpDDSLcl
    Points to a DDRAWI_DDRAWSURFACE_LCL structure that describes the DirectDraw surface to be used as the rendering target.
  • lpDDSZLcl
    Points to a DDRAWI_DDRAWSURFACE_LCL structure that describes the DirectDraw surface to be used as a depth buffer. If this member is NULL, no depth buffering is to be performed.
  • dwPID
    Specifies the current process identifier. This is the process identifier of the Direct3D application that initiated the creation of the Direct3D device.
  • dwhContext
    Specifies the location where the driver returns the context handle upon successfully creating the context. The driver should return a unique context identifier for Direct3D to use when communicating with the driver.
  • ddrval
    Specifies the location where the driver writes the return value of D3dContextCreate. A return code of DD_OK indicates success.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3dhal.h.

See Also

D3dContextCreate | DDRAWI_DIRECTDRAW_LCL | DDRAWI_DDRAWSURFACE_LCL | Structures Associated with Direct3D Callback Functions

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.