PFND3D11_1DDI_RESOURCEUPDATESUBRESOURCEUP callback function

• 05/10/2018
• 2 minutes to read

updates a destination subresource region that stores constant buffers from a source system-memory region. Implemented by Windows Display Driver Model (WDDM) 1.2 and later user-mode display drivers.

Syntax

PFND3D11_1DDI_RESOURCEUPDATESUBRESOURCEUP Pfnd3d111DdiResourceupdatesubresourceup;

void Pfnd3d111DdiResourceupdatesubresourceup(
  D3D10DDI_HDEVICE Arg1,
  D3D10DDI_HRESOURCE Arg2,
  UINT Arg3,
  const D3D10_DDI_BOX *Arg4,
  const VOID *Arg5,
  UINT Arg6,
  UINT Arg7,
  UINT CopyFlags
)
{...}

Parameters

Arg1

hDevice [in]

A handle to the display device (graphics context).

Arg2

hDstResource

A handle to the destination resource to copy to.

Arg3

DstSubresource

An index that indicates the destination subresource to copy to.

Arg4

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.

Arg5

pSysMemUP [in]

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

Arg6

RowPitch

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

Arg7

DepthPitch

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

CopyFlags

A value that specifies characteristics of copy operation as a bitwise OR of the values in the D3D11_1_DDI_COPY_FLAGS enumeration type.

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

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(D3D11_1) (which typically should not happen), the driver can return D3DDDIERR_DEVICEREMOVED.

Requirements

See Also

D3D11_1DDI_DEVICEFUNCS

D3D11_1_DDI_COPY_FLAGS

pfnSetErrorCb