D3D10_DDI_RESOURCE_USAGE enumeration (d3d10umddi.h)

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