kcom.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	STATIC_KoCreateObject   0x72CF721CL, 0x525A, 0x11D1, {0x9A, 0xA1, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96}
#define	KOSTRING_CreateObject   L"{72CF721C-525A-11D1-9AA1-00A0C9223196}"
#define	CLSCTX_KERNEL_SERVER   0x00000200
#define	STATIC_IID_IKoInitializeParentDeviceObject   0x21B36996, 0x8DE3, 0x11D1, 0x8A, 0xE0, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96
#define	COMDDKMETHOD   DECLSPEC_IMPORT
#define	COMDDKAPI   DECLSPEC_IMPORT
#define	INTERFACE   INonDelegatedUnknown
#define	INTERFACE   IIndirectedUnknown
#define	INTERFACE   IKoInitializeParentDeviceObject

Typedefs
typedef NTSTATUS(*	KoCreateObjectHandler) (IN REFCLSID ClassId, IN IUnknown *UnkOuter OPTIONAL, IN REFIID InterfaceId, OUT PVOID *Interface)

Functions
	DEFINE_GUIDSTRUCT ("72CF721C-525A-11D1-9AA1-00A0C9223196", KoCreateObject)
	DEFINE_GUIDEX (IID_IKoInitializeParentDeviceObject)
	DECLARE_INTERFACE (INonDelegatedUnknown)
	DECLARE_INTERFACE (IIndirectedUnknown)
	DECLARE_INTERFACE_ (IKoInitializeParentDeviceObject, IUnknown)
COMDDKAPI void NTAPI	KoRelease (IN REFCLSID ClassId)
COMDDKAPI NTSTATUS NTAPI	KoCreateInstance (IN REFCLSID ClassId, IN IUnknown *UnkOuter OPTIONAL, IN ULONG ClsContext, IN REFIID InterfaceId, OUT PVOID *Interface)
COMDDKAPI NTSTATUS NTAPI	KoDeviceInitialize (IN PDEVICE_OBJECT DeviceObject)
COMDDKAPI NTSTATUS NTAPI	KoDriverInitialize (IN PDRIVER_OBJECT DriverObject, IN PUNICODE_STRING RegistryPathName, IN KoCreateObjectHandler CreateObjectHandler)

Macro Definition Documentation

CLSCTX_KERNEL_SERVER

#define CLSCTX_KERNEL_SERVER   0x00000200

Definition at line 37 of file kcom.h.

COMDDKAPI

#define COMDDKAPI   DECLSPEC_IMPORT

Definition at line 62 of file kcom.h.

COMDDKMETHOD

#define COMDDKMETHOD   DECLSPEC_IMPORT

Definition at line 55 of file kcom.h.

INTERFACE [1/3]

#define INTERFACE   INonDelegatedUnknown

Definition at line 110 of file kcom.h.

INTERFACE [2/3]

#define INTERFACE   IIndirectedUnknown

Definition at line 110 of file kcom.h.

INTERFACE [3/3]

#define INTERFACE   IKoInitializeParentDeviceObject

Definition at line 110 of file kcom.h.

KOSTRING_CreateObject

#define KOSTRING_CreateObject   L"{72CF721C-525A-11D1-9AA1-00A0C9223196}"

Definition at line 34 of file kcom.h.

STATIC_IID_IKoInitializeParentDeviceObject

#define STATIC_IID_IKoInitializeParentDeviceObject   0x21B36996, 0x8DE3, 0x11D1, 0x8A, 0xE0, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96

Definition at line 42 of file kcom.h.

STATIC_KoCreateObject

#define STATIC_KoCreateObject   0x72CF721CL, 0x525A, 0x11D1, {0x9A, 0xA1, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96}

Definition at line 32 of file kcom.h.

Typedef Documentation

KoCreateObjectHandler

typedef NTSTATUS(* KoCreateObjectHandler) (IN REFCLSID ClassId, IN IUnknown *UnkOuter OPTIONAL, IN REFIID InterfaceId, OUT PVOID *Interface)

Definition at line 66 of file kcom.h.

Function Documentation

DECLARE_INTERFACE() [1/2]

DECLARE_INTERFACE

(

IIndirectedUnknown

)

Definition at line 93 of file kcom.h.

                                      {
  STDMETHOD(IndirectedQueryInterface)(
    THIS_
    IN REFIID InterfaceId,
    OUT PVOID* Interface
  ) PURE;
 
  STDMETHOD_(ULONG,IndirectedAddRef)(
    THIS
  ) PURE;
 
  STDMETHOD_(ULONG,IndirectedRelease)(
    THIS
  ) PURE;
};

DECLARE_INTERFACE() [2/2]

DECLARE_INTERFACE

(

INonDelegatedUnknown

)

Definition at line 75 of file kcom.h.

                                        {
  STDMETHOD(NonDelegatedQueryInterface)(
    THIS_
    IN REFIID InterfaceId,
    OUT PVOID* Interface
  ) PURE;
 
  STDMETHOD_(ULONG,NonDelegatedAddRef)(
    THIS
  ) PURE;
 
  STDMETHOD_(ULONG,NonDelegatedRelease)(
    THIS
  ) PURE;
};

DECLARE_INTERFACE_()

DECLARE_INTERFACE_	(	IKoInitializeParentDeviceObject	,
		IUnknown
	)

Definition at line 111 of file kcom.h.

                                                              {
  STDMETHOD(SetParentDeviceObject)(
    THIS_
    IN PDEVICE_OBJECT ParentDeviceObject
  ) PURE;
};

DEFINE_GUIDEX()

DEFINE_GUIDEX

(

IID_IKoInitializeParentDeviceObject

)

DEFINE_GUIDSTRUCT()

DEFINE_GUIDSTRUCT	(	"72CF721C-525A-11D1-9AA1-00A0C9223196"	,
		KoCreateObject
	)

KoCreateInstance()

COMDDKAPI NTSTATUS NTAPI KoCreateInstance	(	IN REFCLSID	ClassId,
		IN IUnknown *UnkOuter	OPTIONAL,
		IN ULONG	ClsContext,
		IN REFIID	InterfaceId,
		OUT PVOID *	Interface
	)

Definition at line 19 of file kcom.c.

{
    /* If UnkOuter isn't NULL, it must be IUnknown - TODO: CHECK THIS PARAM */
    /* TODO: Check IRQL? */
 
    DPRINT("KoCreateInstance called\n");
 
    if ( ClsContext != CLSCTX_KERNEL_SERVER )
    {
        DPRINT("KoCreateInstance: ClsContext must be CLSCTX_KERNEL_SERVER\n");
        return STATUS_INVALID_PARAMETER_3;
    }
 
    if (IsEqualGUIDAligned(InterfaceId, &IID_IUnknown))
    {
        DPRINT("KoCreateInstance: InterfaceId cannot be IID_IUnknown\n");
        return STATUS_INVALID_PARAMETER_4;
    }
 
 
    /*
        Find the desired interface and create an instance.
 
        But we also need to supply a
        pointer which will be set to a list of available interfaces, to
        IoGetDeviceInterfaces.
 
        We can then create a file based on this information and thus talk
        to the appropriate device.
 
        Useful references:
            http://www.freelists.org/archives/wdmaudiodev/01-2003/msg00023.html
 
        TODO
    */
 
    DPRINT("** FAKING SUCCESS **\n");
 
    return STATUS_SUCCESS;
}

KoDeviceInitialize()

COMDDKAPI NTSTATUS NTAPI KoDeviceInitialize

(

IN PDEVICE_OBJECT

DeviceObject

)

Definition at line 1513 of file api.c.

{
    PDEVICE_EXTENSION DeviceExtension;
 
    /* get device extension */
    DeviceExtension = (PDEVICE_EXTENSION)DeviceObject->DeviceExtension;
 
    return KsAddObjectCreateItemToDeviceHeader((KSDEVICE_HEADER)DeviceExtension->DeviceHeader, KopDispatchCreate, NULL, KOSTRING_CreateObject, NULL);
}

KoDriverInitialize()

COMDDKAPI NTSTATUS NTAPI KoDriverInitialize	(	IN PDRIVER_OBJECT	DriverObject,
		IN PUNICODE_STRING	RegistryPathName,
		IN KoCreateObjectHandler	CreateObjectHandler
	)

Definition at line 1530 of file api.c.

{
    PKO_DRIVER_EXTENSION DriverObjectExtension;
    NTSTATUS Status;
 
    /* allocate driver object extension */
    Status = IoAllocateDriverObjectExtension(DriverObject, (PVOID)KoDriverInitialize, sizeof(KO_DRIVER_EXTENSION), (PVOID*)&DriverObjectExtension);
 
    /* did it work */
    if (NT_SUCCESS(Status))
    {
        /* store create handler */
        DriverObjectExtension->CreateObjectHandler = CreateObjectHandler;
 
         /* Setting our IRP handlers */
        DriverObject->MajorFunction[IRP_MJ_PNP] = KsDefaultDispatchPnp;
        DriverObject->MajorFunction[IRP_MJ_POWER] = KsDefaultDispatchPower;
        DriverObject->MajorFunction[IRP_MJ_SYSTEM_CONTROL] = KsDefaultForwardIrp;
 
        /* The driver unload routine */
        DriverObject->DriverUnload = KsNullDriverUnload;
 
        /* The driver-supplied AddDevice */
        DriverObject->DriverExtension->AddDevice = KopAddDevice;
 
        /* KS handles these */
        DPRINT1("Setting KS function handlers\n");
        KsSetMajorFunctionHandler(DriverObject, IRP_MJ_CREATE);
        KsSetMajorFunctionHandler(DriverObject, IRP_MJ_CLOSE);
        KsSetMajorFunctionHandler(DriverObject, IRP_MJ_DEVICE_CONTROL);
 
    }
 
    return Status;
}

Referenced by KoDriverInitialize(), and KopDispatchCreate().

KoRelease()

COMDDKAPI void NTAPI KoRelease

(

IN REFCLSID

ClassId

)

Definition at line 1575 of file api.c.

{
 
}