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 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_max_(), _Outptr_opt_result_bytebuffer_(), _Success_(), _When_(), FxDriverEntry(), FxDriverUnloadCommon(), FxLibraryCommonRegisterClient(), FxLibraryCommonUnregisterClient(), WDF_LIBRARY_REGISTER_CLIENT(), WDF_LIBRARY_UNREGISTER_CLIENT(), WdfDriverMiniportUnload(), WdfGetDriver(), WdfGetTriageInfo(), WdfInterruptGetDevice(), WdfInterruptQueueDpcForIsr(), WdfInterruptQueueWorkItemForIsr(), WdfInterruptWdmGetInterrupt(), WdfObjectAllocateContext(), WdfObjectContextGetObject(), WdfObjectDereferenceActual(), WdfObjectGetTypedContextWorker(), WdfObjectReferenceActual(), WdfRequestSend(), WdfVerifierDbgBreakPoint(), WdfVerifierKeBugCheck(), and WdfWaitLockAcquire().

WdfFunctions

const WDFFUNC* WdfFunctions

Definition at line 24 of file wdfdriverentry.c.