#include <ntddk.h>
#include <windef.h>
#include <fxldr.h>
#include <wdf.h>
#include <ucxclass.h>
#include "ucxstub.h"
#include <debug.h>

Include dependency graph for ucxstub.c:

Macros
#define	NDEBUG

#define	UCX_STUB_MAJOR_VERSION 1

#define	UCX_STUB_MINOR_VERSION 6

Functions
	_IRQL_requires_ (PASSIVE_LEVEL)
	Sends a synchronous IOCTL to the specified device object.

Variables
WDF_BIND_INFO	BindInfo

PWDF_DRIVER_GLOBALS	WdfDriverGlobals

PFN_UCXFUNC	UcxFunctions [UcxFunctionTableNumEntries]

PUCX_DRIVER_GLOBALS	UcxDriverGlobals

static WDF_CLASS_BIND_INFO	UcxStubClassBindInfo

static BOOLEAN	UcxStubBound

Macro Definition Documentation

◆ NDEBUG

#define NDEBUG

Definition at line 20 of file ucxstub.c.

◆ UCX_STUB_MAJOR_VERSION

#define UCX_STUB_MAJOR_VERSION 1

Definition at line 24 of file ucxstub.c.

◆ UCX_STUB_MINOR_VERSION

#define UCX_STUB_MINOR_VERSION 6

Definition at line 25 of file ucxstub.c.

Function Documentation

◆ _IRQL_requires_()

_IRQL_requires_ ( PASSIVE_LEVEL )

Sends a synchronous IOCTL to the specified device object.

Parameters

[in]	IoControlCode	The IOCTL to send to the device.
[in]	DeviceObject	Pointer to the device object that will handle the IOCTL.
[in]	InputBuffer	Optional pointer to a buffer containing input data for the IOCTL. When specified, the buffer should be at least of InputBufferLength size.
[in]	InputBufferLength	Size in bytes, of the buffer pointed by InputBuffer.
[out]	OutputBuffer	Optional pointer to a buffer that will receive output data from the IOCTL. When specified, the buffer should be at least of OutputBufferLength size.
[in]	OutputBufferLength	Size in bytes, of the buffer pointed by OutputBuffer.
[in]	FileObject	Optional pointer to a file object that may be necessary for the IOCTL.

Returns: An NTSTATUS code indicating success or failure of this function.

Note: Must be called at PASSIVE_LEVEL with all APCs enabled.

Lets UCX hook the controller device init. Call before WdfDeviceCreate.

Definition at line 37 of file ucxstub.c.

{
    PWDF_CLASS_BIND_INFO Info = &UcxStubClassBindInfo;
    NTSTATUS Status;
 
    PAGED_CODE();
 
    if (UcxStubBound)
        return STATUS_SUCCESS;
 
    RtlZeroMemory(Info, sizeof(*Info));
    Info->Size = sizeof(*Info);
    Info->ClassName = (PWCHAR)L"Ucx";
    Info->Version.Major = UCX_STUB_MAJOR_VERSION;
    Info->Version.Minor = UCX_STUB_MINOR_VERSION;
    Info->FunctionTable = UcxFunctions;
    Info->FunctionTableCount = UcxFunctionTableNumEntries;
    Info->ClassBindInfo = &UcxDriverGlobals;
 
    /* Typed as PWDF_COMPONENT_GLOBALS*, but clients pass the globals pointer itself */
    Status = WdfVersionBindClass(&BindInfo, (PWDF_COMPONENT_GLOBALS *)WdfDriverGlobals, Info);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("UCX class bind failed 0x%lx\n", Status);
        return Status;
    }
 
    UcxStubBound = TRUE;
    return STATUS_SUCCESS;
}