Expand Minimize

DefaultConstantBufferUpdateSubresourceUP routine

The DefaultConstantBufferUpdateSubresourceUP function updates a destination subresource region that stores constant buffers from a source system-memory region.

Syntax


PFND3D10DDI_RESOURCEUPDATESUBRESOURCEUP DefaultConstantBufferUpdateSubresourceUP;

VOID APIENTRY DefaultConstantBufferUpdateSubresourceUP(
  _In_      D3D10DDI_HDEVICE hDevice,
  _In_      D3D10DDI_HRESOURCE hDstResource,
  _In_      UINT DstSubresource,
  _In_opt_  const D3D10_DDI_BOX *pDstBox,
  _In_      const VOID *pSysMemUP,
  _In_      UINT RowPitch,
  _In_      UINT DepthPitch
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

hDstResource [in]

A handle to the destination resource to copy to.

DstSubresource [in]

An index that indicates the destination subresource to copy to.

pDstBox [in, optional]

A pointer to a D3D10_DDI_BOX structure that specifies the region of the destination subresource to copy data to. If pDstBox is NULL, the driver should copy to the entire destination subresouce.

pSysMemUP [in]

A pointer to the beginning address of the source data that DefaultConstantBufferUpdateSubresourceUP uses to update the destination subresouce.

RowPitch [in]

The offset, in bytes, to move to the next row of source data.

DepthPitch [in]

The offset, in bytes, to move to the next depth slice of source data.

Return value

None.

The driver can use the pfnSetErrorCb callback function to set an error code. For more information about setting error codes, see the following Remarks section.

Remarks

For more information about DefaultConstantBufferUpdateSubresourceUP, see the Remarks section of the ResourceUpdateSubresourceUP function.

The driver should not encounter any error, except for D3DDDIERR_DEVICEREMOVED. Therefore, if the driver passes any error, except for D3DDDIERR_DEVICEREMOVED, in a call to the pfnSetErrorCb function, the Direct3D runtime will determine that the error is critical. Even if the device was removed, the driver is not required to return D3DDDIERR_DEVICEREMOVED; however, if device removal interfered with the operation of DefaultConstantBufferUpdateSubresourceUP (which typically should not happen), the driver can return D3DDDIERR_DEVICEREMOVED.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3d10umddi.h (include D3d10umddi.h)

See also

D3D10_DDI_BOX
D3D10DDI_DEVICEFUNCS
pfnSetErrorCb
ResourceUpdateSubresourceUP

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft