ReactOS  0.4.15-dev-3442-gc05a45e
wmi.c
Go to the documentation of this file.
1 /*
2  * PROJECT: ReactOS InPort (Bus) Mouse Driver
3  * LICENSE: GPL-2.0-or-later (https://spdx.org/licenses/GPL-2.0-or-later)
4  * PURPOSE: WMI support
5  * COPYRIGHT: Copyright 2020 Dmitry Borisov (di.sean@protonmail.com)
6  */
7 
8 /* INCLUDES *******************************************************************/
9 
10 #include "inport.h"
11 
12 #define NDEBUG
13 #include <debug.h>
14 
15 /* GLOBALS ********************************************************************/
16 
18 
20 {
21  {&GuidWmiPortData, 1, 0}
22 };
23 
24 /* FUNCTIONS ******************************************************************/
25 CODE_SEG("PAGE")
27 NTAPI
35 {
36  PINPORT_DEVICE_EXTENSION DeviceExtension = DeviceObject->DeviceExtension;
37 
40 
41  PAGED_CODE();
42 
43  DPRINT("%s()\n", __FUNCTION__);
44 
47  *Pdo = DeviceExtension->Pdo;
48 
49  return STATUS_SUCCESS;
50 }
51 
52 CODE_SEG("PAGE")
54 NTAPI
61  _Out_opt_ PULONG InstanceLengthArray,
64 {
66  PPOINTER_PORT_WMI_STD_DATA InPortData;
67  PINPORT_DEVICE_EXTENSION DeviceExtension = DeviceObject->DeviceExtension;
68 
69  PAGED_CODE();
70 
71  DPRINT("%s()\n", __FUNCTION__);
72 
74  {
76  goto Complete;
77  }
78 
79  /* Only register 1 instance per GUID */
80  if (InstanceIndex != 0 || InstanceCount != 1)
81  {
83  goto Complete;
84  }
85 
86  if (!InstanceLengthArray || BufferAvail < sizeof(POINTER_PORT_WMI_STD_DATA))
87  {
89  goto Complete;
90  }
91 
92  InPortData = (PPOINTER_PORT_WMI_STD_DATA)Buffer;
93 
94  /* Bus mouse connector isn't defined in the DDK, so set type to something generic */
96  /* 1 packet */
97  InPortData->DataQueueSize = 1;
98  /* Not supported by device */
99  InPortData->ErrorCount = 0;
100 
101  InPortData->Buttons = DeviceExtension->MouseAttributes.NumberOfButtons;
103  *InstanceLengthArray = sizeof(POINTER_PORT_WMI_STD_DATA);
104 
106 
107 Complete:
109  Irp,
110  Status,
113 }
114 
115 CODE_SEG("PAGE")
116 NTSTATUS
117 NTAPI
119  _Inout_ PINPORT_DEVICE_EXTENSION DeviceExtension)
120 {
121  PAGED_CODE();
122 
123  DeviceExtension->WmiLibInfo.GuidCount = RTL_NUMBER_OF(InPortWmiGuidList);
124  DeviceExtension->WmiLibInfo.GuidList = InPortWmiGuidList;
125 
126  DeviceExtension->WmiLibInfo.QueryWmiRegInfo = InPortQueryWmiRegInfo;
127  DeviceExtension->WmiLibInfo.QueryWmiDataBlock = InPortQueryWmiDataBlock;
128  DeviceExtension->WmiLibInfo.SetWmiDataBlock = NULL;
129  DeviceExtension->WmiLibInfo.SetWmiDataItem = NULL;
130  DeviceExtension->WmiLibInfo.ExecuteWmiMethod = NULL;
131  DeviceExtension->WmiLibInfo.WmiFunctionControl = NULL;
132 
133  return IoWMIRegistrationControl(DeviceExtension->Self,
135 }
136 
137 CODE_SEG("PAGE")
138 NTSTATUS
139 NTAPI
141  _Inout_ PINPORT_DEVICE_EXTENSION DeviceExtension)
142 {
143  PAGED_CODE();
144 
145  return IoWMIRegistrationControl(DeviceExtension->Self,
147 }
148 
149 CODE_SEG("PAGE")
150 NTSTATUS
151 NTAPI
154  _Inout_ PIRP Irp)
155 {
158  PINPORT_DEVICE_EXTENSION DeviceExtension = DeviceObject->DeviceExtension;
159 
160  PAGED_CODE();
161 
162  DPRINT("%s(%p, %p) %X\n", __FUNCTION__, DeviceObject, Irp,
164 
165  Status = IoAcquireRemoveLock(&DeviceExtension->RemoveLock, Irp);
166  if (!NT_SUCCESS(Status))
167  {
168  Irp->IoStatus.Information = 0;
169  Irp->IoStatus.Status = Status;
171 
172  return Status;
173  }
174 
175  Status = WmiSystemControl(&DeviceExtension->WmiLibInfo,
176  DeviceObject,
177  Irp,
178  &Disposition);
179  switch (Disposition)
180  {
181  case IrpProcessed:
182  break;
183 
184  case IrpNotCompleted:
186  break;
187 
188  case IrpForward:
189  case IrpNotWmi:
191  Status = IoCallDriver(DeviceExtension->Ldo, Irp);
192  break;
193  }
194 
195  IoReleaseRemoveLock(&DeviceExtension->RemoveLock, Irp);
196 
197  return Status;
198 }
PDEVICE_OBJECT Ldo
Definition: inport.h:46
#define STATUS_WMI_GUID_NOT_FOUND
Definition: ntstatus.h:776
#define _Inout_
Definition: ms_sal.h:378
WMIGUIDREGINFO InPortWmiGuidList[]
Definition: wmi.c:19
#define WMIREG_ACTION_DEREGISTER
#define UNREFERENCED_PARAMETER(P)
Definition: ntbasedef.h:317
WMILIB_CONTEXT WmiLibInfo
Definition: inport.h:49
unsigned char * PUCHAR
Definition: retypes.h:3
NTSTATUS NTAPI InPortQueryWmiDataBlock(_Inout_ PDEVICE_OBJECT DeviceObject, _Inout_ PIRP Irp, _In_ ULONG GuidIndex, _In_ ULONG InstanceIndex, _In_ ULONG InstanceCount, _Out_opt_ PULONG InstanceLengthArray, _In_ ULONG BufferAvail, _Out_opt_ PUCHAR Buffer)
Definition: wmi.c:55
NTSTATUS NTAPI WmiSystemControl(IN PWMILIB_CONTEXT WmiLibInfo, IN PDEVICE_OBJECT DeviceObject, IN PIRP Irp, OUT PSYSCTL_IRP_DISPOSITION IrpDisposition)
Definition: wmilib.c:48
LONG NTSTATUS
Definition: precomp.h:26
_Must_inspect_result_ _In_ PDRIVER_OBJECT _In_ PCUNICODE_STRING RegistryPath
Definition: wdfdriver.h:213
_In_ LPGUID _In_ ULONG InstanceIndex
Definition: classpnp.h:1250
#define IoReleaseRemoveLock(_RemoveLock, _Tag)
Definition: iofuncs.h:2764
NTSTATUS NTAPI WmiCompleteRequest(IN PDEVICE_OBJECT DeviceObject, IN PIRP Irp, IN NTSTATUS Status, IN ULONG BufferUsed, IN CCHAR PriorityBoost)
Definition: wmilib.c:24
_In_ ACCESS_MASK _In_ POBJECT_ATTRIBUTES _Reserved_ ULONG _In_opt_ PUNICODE_STRING _In_ ULONG _Out_opt_ PULONG Disposition
Definition: cmfuncs.h:50
#define STATUS_WMI_INSTANCE_NOT_FOUND
Definition: ntstatus.h:777
#define STATUS_BUFFER_TOO_SMALL
Definition: shellext.h:69
NTSTATUS NTAPI InPortQueryWmiRegInfo(_Inout_ PDEVICE_OBJECT DeviceObject, _Inout_ PULONG RegFlags, _Inout_ PUNICODE_STRING InstanceName, _Out_opt_ PUNICODE_STRING *RegistryPath, _Inout_ PUNICODE_STRING MofResourceName, _Out_opt_ PDEVICE_OBJECT *Pdo)
Definition: wmi.c:28
_In_ PDEVICE_OBJECT DeviceObject
Definition: wdfdevice.h:2055
NTSTATUS(* NTAPI)(IN PFILE_FULL_EA_INFORMATION EaBuffer, IN ULONG EaLength, OUT PULONG ErrorOffset)
Definition: IoEaTest.cpp:117
NTSTATUS NTAPI InPortWmiDeRegistration(_Inout_ PINPORT_DEVICE_EXTENSION DeviceExtension)
Definition: wmi.c:140
struct _POINTER_PORT_WMI_STD_DATA * PPOINTER_PORT_WMI_STD_DATA
_In_ PIRP Irp
Definition: csq.h:116
pRequest Complete(RequestStatus)
WDF_EXTERN_C_START typedef _Must_inspect_result_ _In_ WDFDRIVER _In_opt_ PWDF_OBJECT_ATTRIBUTES _In_ PDEVICE_OBJECT _In_opt_ PDEVICE_OBJECT _In_opt_ PDEVICE_OBJECT Pdo
Definition: wdfminiport.h:64
_In_ UCHAR _In_ UCHAR MinorFunction
Definition: wdfdevice.h:1697
_Out_ ULONG * RegFlags
Definition: classpnp.h:403
#define _In_
Definition: ms_sal.h:308
#define IoCompleteRequest
Definition: irp.c:1240
_In_ PIRP _In_ ULONG GuidIndex
Definition: classpnp.h:418
#define WMIREG_FLAG_INSTANCE_PDO
Definition: wmistr.h:69
Definition: bufpool.h:45
struct _POINTER_PORT_WMI_STD_DATA POINTER_PORT_WMI_STD_DATA
NTSTATUS NTAPI IoWMIRegistrationControl(IN PDEVICE_OBJECT DeviceObject, IN ULONG Action)
Definition: wmi.c:68
#define POINTER_PORT_WMI_STD_DATA_GUID
Definition: wmidata.h:315
Status
Definition: gdiplustypes.h:24
#define WMIREG_ACTION_REGISTER
enum _SYSCTL_IRP_DISPOSITION SYSCTL_IRP_DISPOSITION
#define NT_SUCCESS(StatCode)
Definition: apphelp.c:32
NTSTATUS NTAPI InPortWmiRegistration(_Inout_ PINPORT_DEVICE_EXTENSION DeviceExtension)
Definition: wmi.c:118
GUID GuidWmiPortData
Definition: wmi.c:17
PDEVICE_OBJECT Pdo
Definition: inport.h:45
IO_REMOVE_LOCK RemoveLock
Definition: inport.h:48
_In_ PIRP _In_ ULONG _In_ ULONG BufferAvail
Definition: classpnp.h:418
_Must_inspect_result_ _In_ WDFDEVICE _In_ PCUNICODE_STRING MofResourceName
Definition: wdfdevice.h:2461
__drv_aliasesMem FORCEINLINE PIO_STACK_LOCATION IoGetCurrentIrpStackLocation(_In_ PIRP Irp)
Definition: iofuncs.h:2793
#define POINTER_PORT_WMI_STD_MOUSE
Definition: wmidata.h:3180
MOUSE_ATTRIBUTES MouseAttributes
Definition: inport.h:76
UNICODE_STRING DriverRegistryPath
Definition: inport.c:17
#define POINTER_PORT_WMI_STD_I8042
Definition: wmidata.h:3169
#define RTL_NUMBER_OF(x)
Definition: RtlRegistry.c:12
NTSTATUS NTAPI InPortWmi(_In_ PDEVICE_OBJECT DeviceObject, _Inout_ PIRP Irp)
Definition: wmi.c:152
#define _Out_opt_
Definition: ms_sal.h:346
unsigned int * PULONG
Definition: retypes.h:1
#define NULL
Definition: types.h:112
NTSTATUS NTAPI IoCallDriver(IN PDEVICE_OBJECT DeviceObject, IN PIRP Irp)
Definition: irp.c:1218
#define IoSkipCurrentIrpStackLocation(Irp)
Definition: ntifs_ex.h:421
_Must_inspect_result_ _Inout_ PFLT_VOLUME _In_opt_ PCUNICODE_STRING InstanceName
Definition: fltkernel.h:1162
unsigned int ULONG
Definition: retypes.h:1
#define IO_NO_INCREMENT
Definition: iotypes.h:598
_In_ ULONG InstanceCount
Definition: iofuncs.h:1323
#define STATUS_SUCCESS
Definition: shellext.h:65
#define DPRINT
Definition: sndvol32.h:71
#define __FUNCTION__
Definition: types.h:112
USHORT NumberOfButtons
Definition: ntddmou.h:110
static CODE_SEG("PAGE")
Definition: isapnp.c:1482
#define IoAcquireRemoveLock(RemoveLock, Tag)
#define PAGED_CODE()