Edit

Share via

D3D10_DDI_RESOURCE_USAGE enumeration (d3d10umddi.h)

  • Article

The D3D10_DDI_RESOURCE_USAGE enumeration type contains values that identify how a resource is used.

Syntax

typedef enum D3D10_DDI_RESOURCE_USAGE {
  D3D10_DDI_USAGE_DEFAULT,
  D3D10_DDI_USAGE_IMMUTABLE,
  D3D10_DDI_USAGE_DYNAMIC,
  D3D10_DDI_USAGE_STAGING
} ;

Constants

 
D3D10_DDI_USAGE_DEFAULT
The resource is used at the highest level. An application cannot map to default resources. The resources can be bound to the graphics pipeline and used as copy destinations and sources. The Microsoft Direct3D runtime can call only the ResourceUpdateSubresourceUP function to update the contents directly with the CPU.
D3D10_DDI_USAGE_IMMUTABLE
The resource is immutable and cannot be mapped or copied to. The resource can be bound to the pipeline and copied from. The Direct3D runtime cannot call ResourceUpdateSubresourceUP to update the contents; therefore, the contents of the resource are provided at creation time.
D3D10_DDI_USAGE_DYNAMIC
The resource is dynamic and should be resident in non-local video memory. The resource can also be mapped. However, when the resource is mapped, the CPU can only write (and not read) to the resource. Therefore, when mapped, the Direct3D runtime must use the D3D10_DDI_MAP_WRITE_DISCARD or D3D10_DDI_MAP_WRITE_NOOVERWRITE access level in a call to the ResourceMap function. Because this resource can be mapped, the runtime cannot call ResourceUpdateSubresourceUP.
D3D10_DDI_USAGE_STAGING
The resource is a staging resource, which the user-mode display driver should allocate as system memory. The driver allocates system memory to ensure the proper alignment and pitch to enable DMA access to such a region of memory. Staging can be mapped by the application but cannot be bound to the 3-D graphics pipeline. However, staging resources are frequently used to copy between other non-mappable resources. Because this resource can be mapped, the runtime cannot call ResourceUpdateSubresourceUP.

Requirements

Requirement Value
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Header d3d10umddi.h (include D3d10umddi.h)

See also

D3D10DDIARG_CREATERESOURCE

ResourceMap

ResourceUpdateSubresourceUP