GetPriority Method

IDirectDrawSurface7::GetPriority method

Retrieves the texture-management priority for this texture. This method succeeds only on managed textures.

Syntax


HRESULT GetPriority(
  [out] LPDWORD lpdwPriority
);

Parameters

lpdwPriority [out]

A pointer to a variable that receives the texture priority if the call succeeds.

Return value

If the method succeeds, the return value is DD_OK.

If it fails, the return value is an error. The method returns DDERR_INVALIDOBJECT if the parameter is invalid or if the texture is not managed by Direct3D.

Remarks

Priorities are used to determine when managed textures are to be removed from memory. A texture assigned a low priority is removed before a texture with a high priority. If two textures have the same priority, the texture that was used more recently is kept in memory; the other texture is removed.

Applications can set and retrieve priorities only for managed textures (those surfaces that were created with the DDSCAPS2_TEXTUREMANAGE flag). If you call GetPriority on a nonmanaged texture, GetPriority fails and returns DDERR_INVALIDOBJECT.

GetPriority was introduced with the IDirectDrawSurface7 interface.

You must use LoadLibrary to explicitly link to Ddraw.dll and then use GetProcAddress to access the GetPriority method.

Requirements

Header

Ddraw.h

Library

Ddraw.lib

DLL

Ddraw.dll

See also

IDirectDrawSurface7

 

 

Community Additions

ADD
Show:
© 2016 Microsoft