D3DXCheckTextureRequirements 函数
检查纹理创建参数。
语法
HRESULT D3DXCheckTextureRequirements(
_In_ LPDIRECT3DDEVICE9 pDevice,
_Inout_ UINT *pWidth,
_Inout_ UINT *pHeight,
_Inout_ UINT *pNumMipLevels,
_In_ DWORD Usage,
_Inout_ D3DFORMAT *pFormat,
_In_ D3DPOOL Pool
);
parameters
-
pDevice [in]
-
指向 IDirect3DDevice9 接口的指针，表示要与纹理关联的设备。
-
pWidth [in， out]
-
类型： UINT*
指向请求的宽度（以像素为单位）或 NULL 的指针。 返回更正后的大小。
-
pHeight [in， out]
-
类型： UINT*
指向请求的高度（以像素为单位）或 NULL 的指针。 返回更正后的大小。
-
pNumMipLevels [in， out]
-
类型： UINT*
指向请求的 mipmap 级别数的指针，或 NULL。 返回已更正的 mipmap 级别数。
-
用法 [in]
-
类型： DWORD
0 或 D3DUSAGE_RENDERTARGET。 将此标志设置为D3DUSAGE_RENDERTARGET表示表面将用作呈现目标。 然后，可以将资源传递给 SetRenderTarget 方法的 pNewRenderTarget 参数。 如果指定了D3DUSAGE_RENDERTARGET，应用程序应通过调用 CheckDeviceFormat 检查设备支持此操作。
-
pFormat [in， out]
-
类型： D3DFORMAT*
指向 D3DFORMAT 枚举类型的成员的指针。 指定所需的像素格式或 NULL。 返回更正后的格式。
-
池 [in]
-
类型： D3DPOOL
D3DPOOL 枚举类型的成员，描述应放置纹理的内存类。
返回值
类型： HRESULT
如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是以下值之一：D3DERR_INVALIDCALL、D3DERR_NOTAVAILABLE。
备注
如果此函数的参数无效，此函数将返回更正的参数。
将请求的要求与可用格式进行比较时，此函数使用以下启发式：
- 请勿选择通道数较少的格式。
- 除非显式请求，否则请避免 使用 FOURCC 和 24 位格式。
- 尽量不要添加新频道。
- 尽量不要更改每个通道的位数。
- 尽量避免在格式类型之间转换。 例如，避免将 ARGB 格式转换为深度格式。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|
请参阅