wdfdriverentry.c File Reference

#include <ntddk.h>
#include <windef.h>
#include <fxldr.h>
#include "wdf.h"

Include dependency graph for wdfdriverentry.c:

Go to the source code of this file.

Macros
#define	WDFENTRY_TAG   'EFDW'

Functions
NTSTATUS NTAPI	DriverEntry (_In_ PDRIVER_OBJECT DriverObject, _In_ PUNICODE_STRING RegistryPath)
static VOID	FxDriverUnloadCommon (VOID)
VOID NTAPI	FxDriverUnload (_In_ PDRIVER_OBJECT DriverObject)
NTSTATUS NTAPI	FxDriverEntry (_In_ PDRIVER_OBJECT DriverObject, _In_ PUNICODE_STRING RegistryPath)

Variables
const WDFFUNC *	WdfFunctions
PWDF_DRIVER_GLOBALS	WdfDriverGlobals
WDF_BIND_INFO	BindInfo
PDRIVER_UNLOAD	pOriginalUnload = NULL
UNICODE_STRING	gRegistryPath

Macro Definition Documentation

WDFENTRY_TAG

#define WDFENTRY_TAG   'EFDW'

Definition at line 14 of file wdfdriverentry.c.

Function Documentation

DriverEntry()

NTSTATUS NTAPI DriverEntry	(	_In_ PDRIVER_OBJECT	DriverObject,
		_In_ PUNICODE_STRING	RegistryPath
	)

Definition at line 1771 of file compbatt.c.

{
    /* Register add device routine */
    DriverObject->DriverExtension->AddDevice = CompBattAddDevice;
 
    /* Register other handlers */
    DriverObject->MajorFunction[IRP_MJ_CREATE] = CompBattOpenClose;
    DriverObject->MajorFunction[IRP_MJ_CLOSE] = CompBattOpenClose;
    DriverObject->MajorFunction[IRP_MJ_DEVICE_CONTROL] = CompBattIoctl;
    DriverObject->MajorFunction[IRP_MJ_POWER] = CompBattPowerDispatch;
    DriverObject->MajorFunction[IRP_MJ_SYSTEM_CONTROL] = CompBattSystemControl;
    DriverObject->MajorFunction[IRP_MJ_PNP] = CompBattPnpDispatch;
    return STATUS_SUCCESS;
}

FxDriverEntry()

NTSTATUS NTAPI FxDriverEntry	(	_In_ PDRIVER_OBJECT	DriverObject,
		_In_ PUNICODE_STRING	RegistryPath
	)

Definition at line 60 of file wdfdriverentry.c.

{
    NTSTATUS status;
 
    if (DriverObject == NULL)
    {
        return DriverEntry(DriverObject, RegistryPath);
    }
 
    // Copy registry path
    gRegistryPath.MaximumLength = RegistryPath->Length + sizeof(UNICODE_NULL);
    gRegistryPath.Buffer = ExAllocatePoolWithTag(PagedPool,
                                                 gRegistryPath.MaximumLength,
                                                 WDFENTRY_TAG);
 
    if (gRegistryPath.Buffer == NULL)
    {
        return STATUS_INSUFFICIENT_RESOURCES;
    }
 
    RtlCopyUnicodeString(&gRegistryPath, RegistryPath);
 
    // Bind wdf driver to framework
    status = WdfVersionBind(DriverObject,
                            RegistryPath,
                            &BindInfo,
                            (PWDF_COMPONENT_GLOBALS*)(&WdfDriverGlobals));
 
    if (!NT_SUCCESS(status))
    {
        return status;
    }
 
    // Call original entry point
    status = DriverEntry(DriverObject, RegistryPath);
    if (!NT_SUCCESS(status))
    {
        FxDriverUnloadCommon();
        return status;
    }
 
    if (WdfDriverGlobals->DisplaceDriverUnload)
    {
        pOriginalUnload = DriverObject->DriverUnload;
        DriverObject->DriverUnload = FxDriverUnload;
    }
    return STATUS_SUCCESS;
}

FxDriverUnload()

VOID NTAPI FxDriverUnload

(

_In_ PDRIVER_OBJECT

DriverObject

)

Definition at line 48 of file wdfdriverentry.c.

{
    if (pOriginalUnload != NULL)
    {
        pOriginalUnload(DriverObject);
    }
    FxDriverUnloadCommon();
}

FxDriverUnloadCommon()

static VOID FxDriverUnloadCommon ( VOID  )

static

Definition at line 41 of file wdfdriverentry.c.

{
    WdfVersionUnbind(&gRegistryPath, &BindInfo, (PWDF_COMPONENT_GLOBALS)WdfDriverGlobals);
}

Referenced by FxDriverEntry(), and FxDriverUnload().

Variable Documentation

BindInfo

WDF_BIND_INFO BindInfo

Initial value:

=
{
    .Size = sizeof(BindInfo),
    .Component = L"KmdfLibrary", 
    .Version.Major = __WDF_MAJOR_VERSION,
    .Version.Minor = __WDF_MINOR_VERSION,
    .Version.Build = __WDF_BUILD_NUMBER,
    .FuncCount = WdfFunctionTableNumEntries,
    .FuncTable = (WDFFUNC *)&WdfFunctions
}

Definition at line 26 of file wdfdriverentry.c.

Referenced by _IRQL_requires_(), AfdBind(), BindAdapter(), ClassLinkInClient(), DereferenceClassVersion(), FxDriverEntry(), FxDriverUnloadCommon(), GetClassRegistryHandle(), GetClassServicePath(), GetDefaultClassServiceName(), GetDefaultServiceName(), GetVersionRegistryHandle(), GetVersionServicePath(), IPCreateInterface(), LibraryFindClientLocked(), LibraryLinkInClient(), LibraryUnlinkClient(), LoopRegisterAdapter(), main(), ReferenceClassVersion(), WdfVersionBind(), WdfVersionBindClass(), WdfVersionUnbind(), and WdfVersionUnbindClass().

gRegistryPath

UNICODE_STRING gRegistryPath

Definition at line 37 of file wdfdriverentry.c.

Referenced by FxDriverEntry(), and FxDriverUnloadCommon().

pOriginalUnload

PDRIVER_UNLOAD pOriginalUnload = NULL

Definition at line 36 of file wdfdriverentry.c.

Referenced by FxDriverEntry(), and FxDriverUnload().

WdfDriverGlobals

PWDF_DRIVER_GLOBALS WdfDriverGlobals

Definition at line 25 of file wdfdriverentry.c.

Referenced by _IRQL_requires_(), FxDriverEntry(), and FxDriverUnloadCommon().

WdfFunctions

const WDFFUNC* WdfFunctions

Definition at line 24 of file wdfdriverentry.c.