TextureLoader.CheckTextureRequirements Method

Language:

Checks creation parameters for a texture.

Definition

Visual Basic Public Shared Sub CheckTextureRequirements( _
    ByVal device As Device, _
    ByVal usage As Usage, _
    ByVal pool As Pool, _
    ByRef requirements As TextureRequirements _
)

C# public static void CheckTextureRequirements(
    Device device,
    Usage usage,
    Pool pool,
    out TextureRequirements requirements
);

C++ public:
static void CheckTextureRequirements(
    Device^ device,
    Usage usage,
    Pool pool,
    [Out] TextureRequirements% requirements
);

JScript public static function CheckTextureRequirements(
    device : Device,
    usage : Usage,
    pool : Pool,
    requirements : TextureRequirements
);

Visual Basic	Public Shared Sub CheckTextureRequirements( _ ByVal device As Device, _ ByVal usage As Usage, _ ByVal pool As Pool, _ ByRef requirements As TextureRequirements _ )
C#	public static void CheckTextureRequirements( Device device, Usage usage, Pool pool, out TextureRequirements requirements );
C++	public: static void CheckTextureRequirements( Device^ device, Usage usage, Pool pool, [Out] TextureRequirements% requirements );
JScript	public static function CheckTextureRequirements( device : Device, usage : Usage, pool : Pool, requirements : TextureRequirements );

Parameters

device Microsoft.DirectX.Direct3D.Device
A Device object that represents the device to associate with the texture.

usage Microsoft.DirectX.Direct3D.Usage
Value that is either 0 or Usage.RenderTarget. Setting this flag to Usage.RenderTarget indicates that the surface will be used as a render target. The resource can then be passed to the param_Surface_renderTarget parameter of the Device.SetRenderTarget method. If Usage.RenderTarget is specified, the application should determine whether the device supports this operation by calling Manager.CheckDeviceFormat.

pool Microsoft.DirectX.Direct3D.Pool
Member of the Pool enumerated type that describes the memory class into which the texture should be placed.

requirements Microsoft.DirectX.Direct3D.TextureRequirements
A TextureRequirements structure that contains the texture creation parameters.

Remarks

If invalid parameters are passed to this method, it returns corrected parameters.

Exceptions

NotAvailableException This device does not support the queried technique.

InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.

device	Microsoft.DirectX.Direct3D.Device A Device object that represents the device to associate with the texture.
usage	Microsoft.DirectX.Direct3D.Usage Value that is either 0 or Usage.RenderTarget. Setting this flag to Usage.RenderTarget indicates that the surface will be used as a render target. The resource can then be passed to the param_Surface_renderTarget parameter of the Device.SetRenderTarget method. If Usage.RenderTarget is specified, the application should determine whether the device supports this operation by calling Manager.CheckDeviceFormat.
pool	Microsoft.DirectX.Direct3D.Pool Member of the Pool enumerated type that describes the memory class into which the texture should be placed.
requirements	Microsoft.DirectX.Direct3D.TextureRequirements A TextureRequirements structure that contains the texture creation parameters.

NotAvailableException	This device does not support the queried technique.
InvalidCallException	The method call is invalid. For example, a method's parameter might contain an invalid value.