DIFLOGCALLBACK callback function

  • Article

Starting in Windows 10 Version 1607 (Redstone 1), the Driver Install Frameworks (DIFx) tools are no longer included in the WDK.

For more information, see DIFx Guidelines.

A DIFLOGCALLBACK-typed function is an application-supplied callback function that an application registers by calling SetDifxLogCallback. DIFxAPI calls the callback function to log events that occur during DIFxAPI operation.

Syntax

DIFLOGCALLBACK DI_FX_Log_Callback;

void WINAPI DI_FX_Log_Callback(
  DIFXAPI_LOG Event,
  DWORD Error,
  PCTSTR EventDescription,
  PVOID CallbackContext
)
{ ... }

Parameters

Event

A DIFXAPI_LOG-typed enumerator that indicates the event type. The DIFXAPI_LOG enumeration is defined as follows:

typedef enum {
  DIFXAPI_SUCCESS,
  DIFXAPI_INFO,
  DIFXAPI_WARNING,
  DIFXAPI_ERROR
} DIFXAPI_LOG;

The enumeration values represent the event types that are listed in the following table.

Value Event type
DIFXAPI_SUCCESS A success event that logs a message that indicates that an operation succeeded.
DIFXAPI_INFO An information event that logs a message that describes the context or progress of an operation.
DIFXAPI_WARNING A warning event that logs a message about a possible problem that is not a fatal error.
DIFXAPI_ERROR An error event that logs a message about a fatal error.

Error

A DWORD-typed value that specifies a Microsoft Win32 error code that is associated with an event, if one exists; otherwise, Error is zero.

EventDescription

A pointer to a NULL-terminated string that describes the event.

CallbackContext

A pointer to the callback context that a caller set for the callback function.

Return value

None

Remarks

To register a DIFLOGCALLBACK-typed callback function, an application calls SetDifxLogCallback and supplies a pointer to an application-supplied callback function and a pointer to an optional application-specific callback context.

Requirements
Target platform Desktop
Header Difxapi.h (include Difxapi.h)

See also

SetDifxLogCallback