ITileRequest::RequestTextureTileAsync method

Requests to get the contents of a tiled texture as a .DDS (DirectDraw Surface) file.

Syntax

HRESULT RequestTextureTileAsync(
   EventID            eventID,
   DWORD              textureFileptr,
   UINT               tileSubresource,
   UINT               tileX,
   UINT               tileY,
   UINT               tileZ,
   BSTR               ddsFilename,
   ITextureCallback * pRequestCallback,
   DWORD              requestCookie,
   DWORD              progressIntervalMsecs
);

Parameters

eventID
The specified event to match the buffer's content to (for example, a render target could change over time).

textureFileptr
The address of the specified texture object.

tileSubresource
The specified subresource of the tile.

tileX
The specified tile X position.

tileY
The specified tile Y position.

tileZ
The specified tile Z position.

ddsFilename
A COM string that contains the pathname of the .dds file where results are written.

pRequestCallback
The address of callback used to notify the host of results.

requestCookie
A cookie that uniquely identifies the request, and can be used to signal for it to be cancelled.

progressIntervalMsecs
Not used.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

See also

ITileRequest