ITextureRequest::RequestAsync method

  • Article

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

Syntax

HRESULT RequestAsync(
   EventID            eventID,
   DWORD              textureFileptr,
   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 texture object.

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

Header

Vspixengine.h

See also

ITextureRequest