DirectX SDK

IDirect3DDevice7::EnumTextureFormats

The IDirect3DDevice7::EnumTextureFormats method queries the current driver for a list of supported texture formats.

HRESULT EnumTextureFormats(
  LPD3DENUMPIXELFORMATSCALLBACK lpd3dEnumPixelProc,  
  LPVOID lpArg                                           
);

Parameters

lpd3dEnumPixelProc
Address of the D3DEnumPixelFormatsCallback callback function that the enumeration procedure calls for each texture format.
lpArg
Address of application-defined data passed to the callback function.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following:

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

Remarks

In the IDirect3DDevice2 interface, this method accepts a pointer to the legacy D3DEnumTextureFormatsCallback function, not a D3DEnumPixelFormatsCallback.

This method might not enumerate newly implemented texture formats on some devices. Applications that require a texture format that is not enumerated can attempt to create a surface of that format. If the creation attempt succeeds, the format is supported.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Version: Requires DirectX 7.0.
  Header: Declared in d3d.h.