Partager via

DXTMTASKINFO structure

  • Article

Describes a task to be performed by a DXTaskManager (task manager) object.

Syntax

typedef struct DXTMTASKINFO {
  PFNDXTASKPROC pfnTaskProc;
  PVOID         pTaskData;
  PFNDXAPCPROC  pfnCompletionAPC;
  DWORD         dwCompletionData;
  const GUID    *pRequestID;
} DXTMTASKINFO;

Members

  • pfnTaskProc
    Pointer to a DXTASKPROC that specifies the function to execute.

  • pTaskData
    Pointer to the task data used for the function call referred to by pfnTaskProc.

  • pfnCompletionAPC
    Pointer to a DXAPCPROC that specifies an asynchronous procedure call function.

  • dwCompletionData
    Pointer to the data used for the asynchronous procedure call referred to by the pfnCompletionAPC member.

  • pRequestID
    GUID that uniquely identifies the task to the task manager.

Remarks

Using this structure for task management requires that you have already implemented functions for the task manager to execute. You can do this in C++ by adding the following code to your .h file for each function you plan to use.

DXTASKPROC TaskFunctionName;
DXAPCPROC APCFunctionName;

You must next implement these functions in your .cpp file, as shown in the following code sample.

void __stdcall TaskFunctionName(void *pTaskData, BOOL *bContinueProcessing) 
{ /* Insert code here. */ }

void __stdcall __stdcall APCFunctionName(DWORD dwData) 
{ /* Insert code here. */ }

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

 Dxtrans.h

IDL

 Dxtrans.idl

See also

IDXTaskManager::ScheduleTasks