PFND3D10DDI_RESOURCEISSTAGINGBUSY callback function

The ResourceIsStagingBusy function determines whether a resource is currently being used by the graphics pipeline.

Syntax


PFND3D10DDI_RESOURCEISSTAGINGBUSY ResourceIsStagingBusy;

BOOL APIENTRY ResourceIsStagingBusy(
  _In_ D3D10DDI_HDEVICE   hDevice,
  _In_ D3D10DDI_HRESOURCE hResource
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

hResource [in]

A handle to the resource.

Return value

ResourceIsStagingBusy returns a Boolean value that specifies whether the resource that the hResource parameter specifies is currently being used by the graphics pipeline. TRUE indicates that the graphics pipeline currently uses the resource; FALSE indicates that the graphics pipeline currently does not use the resource.

Remarks

The Microsoft Direct3D runtime call to ResourceIsStagingBusy is roughly equivalent to the call to the ResourceMap function with the D3D10_DDI_MAP_FLAG_DONOTWAIT flag set in the Flags parameter, except that ResourceMap can perform only one subresource at a time and ResourceIsStagingBusy can be called while some of the subresources are currently mapped.

The user-mode display driver is not required to flush any partially built command buffer. If the driver is resident in the partially built command buffer, the driver qualifies as busy.

ResourceIsStagingBusy should not encounter any errors. However, ResourceIsStagingBusy might call the pfnSetErrorCb function for critical errors.

Requirements

Target platform

Desktop

Version

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

Header

D3d10umddi.h (include D3d10umddi.h)

See also

D3D10DDI_DEVICEFUNCS
pfnSetErrorCb
ResourceMap

 

 

Send comments about this topic to Microsoft

Show: