version.cpp File Reference

#include <ntverp.h>
#include "mx.h"
#include "fxmin.hpp"
#include "fxldrum.h"
#include "fxifr.h"
#include <strsafe.h>
#include <driverspecs.h>
#include "fxdynamics.h"
#include "..\librarycommon\fxlibrarycommon.h"
#include "umdfstub.h"

Include dependency graph for version.cpp:

Go to the source code of this file.

Macros
#define	FX_DYNAMICS_GENERATE_TABLE   1
#define	KMDF_DEFAULT_NAME
#define	EVTLOG_MESSAGE_SIZE   70
#define	RAW_DATA_SIZE   4
#define	DECLARE_TYPE(Name)   Name* _DECL_##Name

Functions
NTSTATUS	WDF_LIBRARY_COMMISSION (VOID)
NTSTATUS	WDF_LIBRARY_DECOMMISSION (VOID)
NTSTATUS	WDF_LIBRARY_REGISTER_CLIENT (PWDF_BIND_INFO Info, PWDF_DRIVER_GLOBALS *WdfDriverGlobals, PVOID *Context)
NTSTATUS	WDF_LIBRARY_UNREGISTER_CLIENT (PWDF_BIND_INFO Info, PWDF_DRIVER_GLOBALS WdfDriverGlobals)

Variables
const WDFFUNC *	WdfFunctions
ULONG	WdfLdrDbgPrintOn = 0
PCHAR	WdfLdrType = KMDF_DEFAULT_NAME
WDF_LIBRARY_INFO	WdfLibraryInfo
union {
}	uAllPublicTypes

Macro Definition Documentation

DECLARE_TYPE

#define DECLARE_TYPE

(

Name

)

Name* _DECL_##Name

Definition at line 287 of file version.cpp.

EVTLOG_MESSAGE_SIZE

#define EVTLOG_MESSAGE_SIZE   70

Definition at line 134 of file version.cpp.

FX_DYNAMICS_GENERATE_TABLE

#define FX_DYNAMICS_GENERATE_TABLE   1

Definition at line 31 of file version.cpp.

KMDF_DEFAULT_NAME

#define KMDF_DEFAULT_NAME

Value:

                             "Wdf" ## \
                             LITERAL(__WDF_MAJOR_VERSION)   ## \
                             "000"

Definition at line 52 of file version.cpp.

RAW_DATA_SIZE

#define RAW_DATA_SIZE   4

Definition at line 135 of file version.cpp.

Function Documentation

WDF_LIBRARY_COMMISSION()

NTSTATUS WDF_LIBRARY_COMMISSION

(

VOID

)

Definition at line 115 of file version.cpp.

{
    return FxLibraryCommonCommission();
}

WDF_LIBRARY_DECOMMISSION()

NTSTATUS WDF_LIBRARY_DECOMMISSION

(

VOID

)

Definition at line 127 of file version.cpp.

{
    return FxLibraryCommonDecommission();
}

WDF_LIBRARY_REGISTER_CLIENT()

NTSTATUS WDF_LIBRARY_REGISTER_CLIENT	(	PWDF_BIND_INFO	Info,
		PWDF_DRIVER_GLOBALS *	WdfDriverGlobals,
		PVOID *	Context
	)

Definition at line 139 of file version.cpp.

{
    NTSTATUS           status = STATUS_INVALID_PARAMETER;
    PFX_DRIVER_GLOBALS pFxDriverGlobals;
    WCHAR              insertString[EVTLOG_MESSAGE_SIZE];
    ULONG              rawData[RAW_DATA_SIZE];
    PCLIENT_INFO       clientInfo = NULL;
 
    __Print((LITERAL(WDF_LIBRARY_REGISTER_CLIENT) ": enter\n"));
 
    clientInfo = (PCLIENT_INFO)*Context;
    *Context = NULL;
 
    ASSERT(Info->Version.Major == WdfLibraryInfo.Version.Major);
 
    //
    // NOTE: If the currently loaded  library < drivers minor version fail the load
    // instead of binding to a lower minor version. The reason for that if there
    // is a newer API or new contract change made the driver shouldn't be using older
    // API than it was compiled with.
    //
 
    if (Info->Version.Minor > WdfLibraryInfo.Version.Minor) {
        status = StringCchPrintfW(insertString,
                                     RTL_NUMBER_OF(insertString),
                                     L"Driver Version: %d.%d Umdf Lib. Version: %d.%d",
                                     Info->Version.Major,
                                     Info->Version.Minor,
                                     WdfLibraryInfo.Version.Major,
                                     WdfLibraryInfo.Version.Minor);
        if (!NT_SUCCESS(status)) {
            __Print(("ERROR: RtlStringCchPrintfW failed with Status 0x%x\n", status));
            return status;
        }
        rawData[0] = Info->Version.Major;
        rawData[1] = Info->Version.Minor;
        rawData[2] = WdfLibraryInfo.Version.Major;
        rawData[3] = WdfLibraryInfo.Version.Minor;
 
 
 
 
 
 
 
 
 
 
 
        //
        // this looks like the best status to return
        //
        return STATUS_OBJECT_TYPE_MISMATCH;
 
    }
 
    status = FxLibraryCommonRegisterClient(Info, WdfDriverGlobals, clientInfo);
 
    if (NT_SUCCESS(status)) {
        //
        // The context will be a pointer to FX_DRIVER_GLOBALS
        //
        *Context = GetFxDriverGlobals(*WdfDriverGlobals);
 
        //
        // Set the WDF_BIND_INFO structure pointer in FxDriverGlobals
        //
        pFxDriverGlobals = GetFxDriverGlobals(*WdfDriverGlobals);
        pFxDriverGlobals->WdfBindInfo = Info;
    }
 
    return status;
}

WDF_LIBRARY_UNREGISTER_CLIENT()

NTSTATUS WDF_LIBRARY_UNREGISTER_CLIENT	(	PWDF_BIND_INFO	Info,
		PWDF_DRIVER_GLOBALS	WdfDriverGlobals
	)

Definition at line 219 of file version.cpp.

{
    return FxLibraryCommonUnregisterClient(Info, WdfDriverGlobals);
}

Variable Documentation

union { ... } uAllPublicTypes

WdfFunctions

const WDFFUNC* WdfFunctions

extern

Definition at line 24 of file wdfdriverentry.c.

WdfLdrDbgPrintOn

ULONG WdfLdrDbgPrintOn = 0

Definition at line 62 of file version.cpp.

Referenced by FxLibraryCommonRegisterClient().

WdfLdrType

PCHAR WdfLdrType = KMDF_DEFAULT_NAME

Definition at line 64 of file version.cpp.

Referenced by FxInitializeBugCheckDriverInfo().

WdfLibraryInfo

WDF_LIBRARY_INFO WdfLibraryInfo

Initial value:

= {
    sizeof(WDF_LIBRARY_INFO),
    (PFNLIBRARYCOMMISSION)        WDF_LIBRARY_COMMISSION,
    (PFNLIBRARYDECOMMISSION)      WDF_LIBRARY_DECOMMISSION,
    (PFNLIBRARYREGISTERCLIENT)    WDF_LIBRARY_REGISTER_CLIENT,
    (PFNLIBRARYUNREGISTERCLIENT)  WDF_LIBRARY_UNREGISTER_CLIENT,
    { __WUDF_MAJOR_VERSION, __WUDF_MINOR_VERSION, __WUDF_SERVICE_VERSION }
}

Definition at line 99 of file version.cpp.