[DDK]

* Update hidclass.h and hubbusif.h annotations.

svn path=/trunk/; revision=55125

reactos/include/ddk/hidclass.h

@@ -98,13 +98,16 @@ enum DeviceObjectState {
   DeviceObjectRemoved
 };
 
-typedef VOID (NTAPI *PHID_STATUS_CHANGE)(
-  PVOID  Context,
-  enum DeviceObjectState  State);
+typedef VOID
+(NTAPI *PHID_STATUS_CHANGE)(
+  _In_ PVOID Context,
+  _In_ enum DeviceObjectState State);
 
-typedef NTSTATUS (NTAPI *PHIDP_GETCAPS)(
-  IN PHIDP_PREPARSED_DATA  PreparsedData,
-  OUT PHIDP_CAPS  Capabilities);
+_Must_inspect_result_
+typedef NTSTATUS
+(NTAPI *PHIDP_GETCAPS)(
+  _In_ PHIDP_PREPARSED_DATA PreparsedData,
+  _Out_ PHIDP_CAPS Capabilities);
 
 typedef struct _HID_COLLECTION_INFORMATION {
   ULONG  DescriptorSize;

reactos/include/ddk/hubbusif.h

@@ -32,15 +32,15 @@ typedef struct _ROOTHUB_PDO_EXTENSION {
 #define USB_IDLE_NOT_READY      0
 #define USB_IDLE_READY          1
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_CREATE_USB_DEVICE)
+typedef NTSTATUS
 USB_BUSIFFN
 USB_BUSIFFN_CREATE_USB_DEVICE (
-  IN PVOID BusContext,
-  OUT PUSB_DEVICE_HANDLE *NewDeviceHandle,
-  IN PUSB_DEVICE_HANDLE HubDeviceHandle,
-  IN USHORT PortStatus,
-  IN USHORT PortNumber);
+  _In_ PVOID BusContext,
+  _Outptr_ PUSB_DEVICE_HANDLE *NewDeviceHandle,
+  _In_ PUSB_DEVICE_HANDLE HubDeviceHandle,
+  _In_ USHORT PortStatus,
+  _In_ USHORT PortNumber);
 typedef USB_BUSIFFN_CREATE_USB_DEVICE *PUSB_BUSIFFN_CREATE_USB_DEVICE;
 
 typedef enum _USBPORT_CREATEDEV_ERROR {
@@ -63,17 +63,17 @@ typedef struct _USB_CD_ERROR_INFORMATION {
   UCHAR XtraInfo[64];
 } USB_CD_ERROR_INFORMATION, *PUSB_CD_ERROR_INFORMATION;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_CREATE_USB_DEVICE_EX)
+typedef NTSTATUS
 USB_BUSIFFN
 USB_BUSIFFN_CREATE_USB_DEVICE_EX (
-  IN PVOID BusContext,
-  OUT PUSB_DEVICE_HANDLE *NewDeviceHandle,
-  IN PUSB_DEVICE_HANDLE HsHubDeviceHandle,
-  IN USHORT PortStatus,
-  IN USHORT PortNumber,
-  OUT PUSB_CD_ERROR_INFORMATION CdErrorInfo,
-  IN USHORT TtPortNumber);
+  _In_ PVOID BusContext,
+  _Outptr_ PUSB_DEVICE_HANDLE *NewDeviceHandle,
+  _In_ PUSB_DEVICE_HANDLE HsHubDeviceHandle,
+  _In_ USHORT PortStatus,
+  _In_ USHORT PortNumber,
+  _Out_ PUSB_CD_ERROR_INFORMATION CdErrorInfo,
+  _In_ USHORT TtPortNumber);
 typedef USB_BUSIFFN_CREATE_USB_DEVICE_EX *PUSB_BUSIFFN_CREATE_USB_DEVICE_EX;
 
 typedef struct _USB_PORT_PATH {
@@ -81,19 +81,19 @@ typedef struct _USB_PORT_PATH {
   ULONG PortPath[6];
 } USB_PORT_PATH, *PUSB_PORT_PATH;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_CREATE_USB_DEVICE_V7)
+typedef NTSTATUS
 USB_BUSIFFN
 USB_BUSIFFN_CREATE_USB_DEVICE_V7 (
-  IN PVOID BusContext,
-  OUT PUSB_DEVICE_HANDLE *NewDeviceHandle,
-  IN PUSB_DEVICE_HANDLE HsHubDeviceHandle,
-  IN USHORT PortStatus,
-  IN PUSB_PORT_PATH PortPath,
-  OUT PUSB_CD_ERROR_INFORMATION CdErrorInfo,
-  IN USHORT TtPortNumber,
-  IN PDEVICE_OBJECT PdoDeviceObject,
-  IN PUNICODE_STRING PhysicalDeviceObjectName);
+  _In_ PVOID BusContext,
+  _Outptr_ PUSB_DEVICE_HANDLE *NewDeviceHandle,
+  _In_ PUSB_DEVICE_HANDLE HsHubDeviceHandle,
+  _In_ USHORT PortStatus,
+  _In_ PUSB_PORT_PATH PortPath,
+  _Out_ PUSB_CD_ERROR_INFORMATION CdErrorInfo,
+  _In_ USHORT TtPortNumber,
+  _In_ PDEVICE_OBJECT PdoDeviceObject,
+  _In_ PUNICODE_STRING PhysicalDeviceObjectName);
 typedef USB_BUSIFFN_CREATE_USB_DEVICE_V7 *PUSB_BUSIFFN_CREATE_USB_DEVICE_V7;
 
 typedef enum _USBPORT_INITDEV_ERROR {
@@ -113,300 +113,306 @@ typedef struct _USB_ID_ERROR_INFORMATION {
   UCHAR XtraInfo[64];
 } USB_ID_ERROR_INFORMATION, *PUSB_ID_ERROR_INFORMATION;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_INITIALIZE_USB_DEVICE)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_INITIALIZE_USB_DEVICE (
-  IN PVOID BusContext,
-  IN OUT PUSB_DEVICE_HANDLE DeviceHandle);
+USB_BUSIFFN_INITIALIZE_USB_DEVICE(
+  _In_ PVOID BusContext,
+  _Inout_ PUSB_DEVICE_HANDLE DeviceHandle);
 typedef USB_BUSIFFN_INITIALIZE_USB_DEVICE *PUSB_BUSIFFN_INITIALIZE_USB_DEVICE;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_INITIALIZE_USB_DEVICE_EX)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_INITIALIZE_USB_DEVICE_EX (
-  IN PVOID BusContext,
-  IN OUT PUSB_DEVICE_HANDLE DeviceHandle,
-  OUT PUSB_ID_ERROR_INFORMATION IdErrInfo);
+USB_BUSIFFN_INITIALIZE_USB_DEVICE_EX(
+  _In_ PVOID BusContext,
+  _Inout_ PUSB_DEVICE_HANDLE DeviceHandle,
+  _Out_ PUSB_ID_ERROR_INFORMATION IdErrInfo);
 typedef USB_BUSIFFN_INITIALIZE_USB_DEVICE_EX *PUSB_BUSIFFN_INITIALIZE_USB_DEVICE_EX;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_REMOVE_USB_DEVICE)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_REMOVE_USB_DEVICE (
-  IN PVOID BusContext,
-  IN OUT PUSB_DEVICE_HANDLE DeviceHandle,
-  IN ULONG Flags);
+USB_BUSIFFN_REMOVE_USB_DEVICE(
+  _In_ PVOID BusContext,
+  _Inout_ PUSB_DEVICE_HANDLE DeviceHandle,
+  _In_ ULONG Flags);
 typedef USB_BUSIFFN_REMOVE_USB_DEVICE *PUSB_BUSIFFN_REMOVE_USB_DEVICE;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_GET_USB_DESCRIPTORS)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_GET_USB_DESCRIPTORS (
-  IN PVOID BusContext,
-  IN OUT PUSB_DEVICE_HANDLE DeviceHandle,
-  OUT PUCHAR DeviceDescriptorBuffer,
-  IN OUT PULONG DeviceDescriptorBufferLength,
-  OUT PUCHAR ConfigDescriptorBuffer,
-  IN OUT PULONG ConfigDescriptorBufferLength);
+USB_BUSIFFN_GET_USB_DESCRIPTORS(
+  _In_ PVOID BusContext,
+  _Inout_ PUSB_DEVICE_HANDLE DeviceHandle,
+  _Out_writes_bytes_to_(*DeviceDescriptorBufferLength,*DeviceDescriptorBufferLength)
+    PUCHAR DeviceDescriptorBuffer,
+  _Inout_ PULONG DeviceDescriptorBufferLength,
+  _Out_writes_bytes_to_(*ConfigDescriptorBufferLength, *ConfigDescriptorBufferLength)
+    PUCHAR ConfigDescriptorBuffer,
+  _Inout_ PULONG ConfigDescriptorBufferLength);
 typedef USB_BUSIFFN_GET_USB_DESCRIPTORS *PUSB_BUSIFFN_GET_USB_DESCRIPTORS;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_RESTORE_DEVICE)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_RESTORE_DEVICE (
-  IN PVOID BusContext,
-  IN OUT PUSB_DEVICE_HANDLE OldDeviceHandle,
-  IN OUT PUSB_DEVICE_HANDLE NewDeviceHandle);
+USB_BUSIFFN_RESTORE_DEVICE(
+  _In_ PVOID BusContext,
+  _Inout_ PUSB_DEVICE_HANDLE OldDeviceHandle,
+  _Inout_ PUSB_DEVICE_HANDLE NewDeviceHandle);
 typedef USB_BUSIFFN_RESTORE_DEVICE *PUSB_BUSIFFN_RESTORE_DEVICE;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_GET_POTRTHACK_FLAGS)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_GET_POTRTHACK_FLAGS (
-  IN PVOID BusContext,
-  IN OUT PULONG Flags);
+USB_BUSIFFN_GET_POTRTHACK_FLAGS(
+  _In_ PVOID BusContext,
+  _Inout_ PULONG Flags);
 typedef USB_BUSIFFN_GET_POTRTHACK_FLAGS *PUSB_BUSIFFN_GET_POTRTHACK_FLAGS;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_GET_DEVICE_INFORMATION)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_GET_DEVICE_INFORMATION (
-  IN PVOID BusContext,
-  IN PUSB_DEVICE_HANDLE DeviceHandle,
-  OUT PVOID DeviceInformationBuffer,
-  IN ULONG DeviceInformationBufferLength,
-  IN OUT PULONG LengthOfDataCopied);
+USB_BUSIFFN_GET_DEVICE_INFORMATION(
+  _In_ PVOID BusContext,
+  _In_ PUSB_DEVICE_HANDLE DeviceHandle,
+  _Out_writes_bytes_to_(DeviceInformationBufferLength,*LengthOfDataCopied)
+    PVOID DeviceInformationBuffer,
+  _In_ ULONG DeviceInformationBufferLength,
+  _Inout_ PULONG LengthOfDataCopied);
 typedef USB_BUSIFFN_GET_DEVICE_INFORMATION *PUSB_BUSIFFN_GET_DEVICE_INFORMATION;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_GET_CONTROLLER_INFORMATION)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_GET_CONTROLLER_INFORMATION (
-  IN PVOID BusContext,
-  IN OUT PVOID ControllerInformationBuffer,
-  IN ULONG ControllerInformationBufferLength,
-  IN OUT PULONG LengthOfDataCopied);
+USB_BUSIFFN_GET_CONTROLLER_INFORMATION(
+  _In_ PVOID BusContext,
+  _Inout_updates_bytes_to_(ControllerInformationBufferLength, *LengthOfDataCopied)
+    PVOID ControllerInformationBuffer,
+  _In_ ULONG ControllerInformationBufferLength,
+  _Inout_ PULONG LengthOfDataCopied);
 typedef USB_BUSIFFN_GET_CONTROLLER_INFORMATION *PUSB_BUSIFFN_GET_CONTROLLER_INFORMATION;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_CONTROLLER_SELECTIVE_SUSPEND)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_CONTROLLER_SELECTIVE_SUSPEND (
-  IN PVOID BusContext,
-  IN BOOLEAN Enable);
+USB_BUSIFFN_CONTROLLER_SELECTIVE_SUSPEND(
+  _In_ PVOID BusContext,
+  _In_ BOOLEAN Enable);
 typedef USB_BUSIFFN_CONTROLLER_SELECTIVE_SUSPEND *PUSB_BUSIFFN_CONTROLLER_SELECTIVE_SUSPEND;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_GET_EXTENDED_HUB_INFO)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_GET_EXTENDED_HUB_INFO (
-  IN PVOID BusContext,
-  IN PDEVICE_OBJECT HubPhysicalDeviceObject,
-  IN PVOID HubInformationBuffer,
-  IN ULONG HubInformationBufferLength,
-  OUT PULONG LengthOfDataCopied);
+USB_BUSIFFN_GET_EXTENDED_HUB_INFO(
+  _In_ PVOID BusContext,
+  _In_ PDEVICE_OBJECT HubPhysicalDeviceObject,
+  _Inout_updates_bytes_to_(HubInformationBufferLength, *LengthOfDataCopied)
+    PVOID HubInformationBuffer,
+  _In_ ULONG HubInformationBufferLength,
+  _Out_ PULONG LengthOfDataCopied);
 typedef USB_BUSIFFN_GET_EXTENDED_HUB_INFO *PUSB_BUSIFFN_GET_EXTENDED_HUB_INFO;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_GET_ROOTHUB_SYM_NAME)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_GET_ROOTHUB_SYM_NAME (
-  IN PVOID BusContext,
-  IN PVOID HubSymNameBuffer,
-  IN ULONG HubSymNameBufferLength,
-  OUT PULONG HubSymNameActualLength);
+USB_BUSIFFN_GET_ROOTHUB_SYM_NAME(
+  _In_ PVOID BusContext,
+  _Inout_updates_bytes_to_(HubSymNameBufferLength, *HubSymNameActualLength) PVOID HubSymNameBuffer,
+  _In_ ULONG HubSymNameBufferLength,
+  _Out_ PULONG HubSymNameActualLength);
 typedef USB_BUSIFFN_GET_ROOTHUB_SYM_NAME *PUSB_BUSIFFN_GET_ROOTHUB_SYM_NAME;
 
-typedef
-PVOID
+_Function_class_(USB_BUSIFFN_GET_DEVICE_BUSCONTEXT)
+typedef PVOID
 USB_BUSIFFN
-USB_BUSIFFN_GET_DEVICE_BUSCONTEXT (
-  IN PVOID HubBusContext,
-  IN PVOID DeviceHandle);
+USB_BUSIFFN_GET_DEVICE_BUSCONTEXT(
+  _In_ PVOID HubBusContext,
+  _In_ PVOID DeviceHandle);
 typedef USB_BUSIFFN_GET_DEVICE_BUSCONTEXT *PUSB_BUSIFFN_GET_DEVICE_BUSCONTEXT;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_INITIALIZE_20HUB)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_INITIALIZE_20HUB (
-  IN PVOID BusContext,
-  IN PUSB_DEVICE_HANDLE HubDeviceHandle,
-  IN ULONG TtCount);
+USB_BUSIFFN_INITIALIZE_20HUB(
+  _In_ PVOID BusContext,
+  _In_ PUSB_DEVICE_HANDLE HubDeviceHandle,
+  _In_ ULONG TtCount);
 typedef USB_BUSIFFN_INITIALIZE_20HUB *PUSB_BUSIFFN_INITIALIZE_20HUB;
 
-typedef
-BOOLEAN
+_Function_class_(USB_BUSIFFN_IS_ROOT)
+typedef BOOLEAN
 USB_BUSIFFN
-USB_BUSIFFN_IS_ROOT (
-  IN PVOID BusContext,
-  IN PVOID DeviceObject);
+USB_BUSIFFN_IS_ROOT(
+  _In_ PVOID BusContext,
+  _In_ PVOID DeviceObject);
 typedef USB_BUSIFFN_IS_ROOT *PUSB_BUSIFFN_IS_ROOT;
 
-typedef
-VOID
+_Function_class_(USB_BUSIFFN_ACQUIRE_SEMAPHORE)
+typedef VOID
 USB_BUSIFFN
-USB_BUSIFFN_ACQUIRE_SEMAPHORE (
-  IN PVOID BusContext);
+USB_BUSIFFN_ACQUIRE_SEMAPHORE(
+  _In_ PVOID BusContext);
 typedef USB_BUSIFFN_ACQUIRE_SEMAPHORE *PUSB_BUSIFFN_ACQUIRE_SEMAPHORE;
 
-typedef
-VOID
+_Function_class_(USB_BUSIFFN_RELEASE_SEMAPHORE)
+typedef VOID
 USB_BUSIFFN
-USB_BUSIFFN_RELEASE_SEMAPHORE (
-  IN PVOID BusContext);
+USB_BUSIFFN_RELEASE_SEMAPHORE(
+  _In_ PVOID BusContext);
 typedef USB_BUSIFFN_RELEASE_SEMAPHORE *PUSB_BUSIFFN_RELEASE_SEMAPHORE;
 
-typedef
-VOID
+_Function_class_(RH_INIT_CALLBACK)
+typedef VOID
 __stdcall
-RH_INIT_CALLBACK (
-  IN PVOID CallBackContext);
+RH_INIT_CALLBACK(
+  _In_ PVOID CallBackContext);
 typedef RH_INIT_CALLBACK *PRH_INIT_CALLBACK;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_ROOTHUB_INIT_NOTIFY)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_ROOTHUB_INIT_NOTIFY (
-  IN PVOID BusContext,
-  IN PVOID CallbackContext,
-  IN PRH_INIT_CALLBACK CallbackRoutine);
+USB_BUSIFFN_ROOTHUB_INIT_NOTIFY(
+  _In_ PVOID BusContext,
+  _In_ PVOID CallbackContext,
+  _In_ PRH_INIT_CALLBACK CallbackRoutine);
 typedef USB_BUSIFFN_ROOTHUB_INIT_NOTIFY *PUSB_BUSIFFN_ROOTHUB_INIT_NOTIFY;
 
-typedef
-VOID
+_Function_class_(USB_BUSIFFN_FLUSH_TRANSFERS)
+typedef VOID
 USB_BUSIFFN
-USB_BUSIFFN_FLUSH_TRANSFERS (
-  IN PVOID BusContext,
-  IN PVOID DeviceHandle);
+USB_BUSIFFN_FLUSH_TRANSFERS(
+  _In_ PVOID BusContext,
+  _In_ PVOID DeviceHandle);
 typedef USB_BUSIFFN_FLUSH_TRANSFERS *PUSB_BUSIFFN_FLUSH_TRANSFERS;
 
-typedef
-ULONG
+_Function_class_(USB_BUSIFFN_CALC_PIPE_BANDWIDTH)
+typedef ULONG
 USB_BUSIFFN
-USB_BUSIFFN_CALC_PIPE_BANDWIDTH (
-  IN PVOID BusContext,
-  IN PUSBD_PIPE_INFORMATION PipeInfo,
-  IN USB_DEVICE_SPEED DeviceSpeed);
+USB_BUSIFFN_CALC_PIPE_BANDWIDTH(
+  _In_ PVOID BusContext,
+  _In_ PUSBD_PIPE_INFORMATION PipeInfo,
+  _In_ USB_DEVICE_SPEED DeviceSpeed);
 typedef USB_BUSIFFN_CALC_PIPE_BANDWIDTH *PUSB_BUSIFFN_CALC_PIPE_BANDWIDTH;
 
-typedef
-VOID
+_Function_class_(USB_BUSIFFN_SET_BUS_WAKE_MODE)
+typedef VOID
 USB_BUSIFFN
-USB_BUSIFFN_SET_BUS_WAKE_MODE (
-  IN PVOID BusContext,
-  IN ULONG Mode);
+USB_BUSIFFN_SET_BUS_WAKE_MODE(
+  _In_ PVOID BusContext,
+  _In_ ULONG Mode);
 typedef USB_BUSIFFN_SET_BUS_WAKE_MODE *PUSB_BUSIFFN_SET_BUS_WAKE_MODE;
 
-typedef
-VOID
+_Function_class_(USB_BUSIFFN_SET_DEVICE_FLAG)
+typedef VOID
 USB_BUSIFFN
-USB_BUSIFFN_SET_DEVICE_FLAG (
-  IN PVOID BusContext,
-  IN GUID *DeviceFlagGuid,
-  IN PVOID ValueData,
-  IN ULONG ValueLength);
+USB_BUSIFFN_SET_DEVICE_FLAG(
+  _In_ PVOID BusContext,
+  _In_ GUID *DeviceFlagGuid,
+  _In_ PVOID ValueData,
+  _In_ ULONG ValueLength);
 typedef USB_BUSIFFN_SET_DEVICE_FLAG *PUSB_BUSIFFN_SET_DEVICE_FLAG;
 
-typedef
-VOID
+_Function_class_(USB_BUSIFFN_SET_DEVHANDLE_DATA)
+typedef VOID
 USB_BUSIFFN
-USB_BUSIFFN_SET_DEVHANDLE_DATA (
-  IN PVOID BusContext,
-  IN PVOID DeviceHandle,
-  IN PDEVICE_OBJECT UsbDevicePdo);
+USB_BUSIFFN_SET_DEVHANDLE_DATA(
+  _In_ PVOID BusContext,
+  _In_ PVOID DeviceHandle,
+  _In_ PDEVICE_OBJECT UsbDevicePdo);
 typedef USB_BUSIFFN_SET_DEVHANDLE_DATA *PUSB_BUSIFFN_SET_DEVHANDLE_DATA;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_TEST_POINT)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_TEST_POINT (
-  IN PVOID BusContext,
-  IN PVOID DeviceHandle,
-  IN ULONG Opcode,
-  IN PVOID TestData);
+USB_BUSIFFN_TEST_POINT(
+  _In_ PVOID BusContext,
+  _In_ PVOID DeviceHandle,
+  _In_ ULONG Opcode,
+  _In_ PVOID TestData);
 typedef USB_BUSIFFN_TEST_POINT *PUSB_BUSIFFN_TEST_POINT;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_GET_DEVICE_PERFORMANCE_INFO)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_GET_DEVICE_PERFORMANCE_INFO (
-  IN PVOID BusContext,
-  IN PUSB_DEVICE_HANDLE DeviceHandle,
-  OUT PVOID DeviceInformationBuffer,
-  IN ULONG DeviceInformationBufferLength,
-  IN OUT PULONG LengthOfDataCopied);
+USB_BUSIFFN_GET_DEVICE_PERFORMANCE_INFO(
+  _In_ PVOID BusContext,
+  _In_ PUSB_DEVICE_HANDLE DeviceHandle,
+  _Out_writes_bytes_to_(DeviceInformationBufferLength,*LengthOfDataCopied)
+    PVOID DeviceInformationBuffer,
+  _In_ ULONG DeviceInformationBufferLength,
+  _Inout_ PULONG LengthOfDataCopied);
 typedef USB_BUSIFFN_GET_DEVICE_PERFORMANCE_INFO *PUSB_BUSIFFN_GET_DEVICE_PERFORMANCE_INFO;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_WAIT_ASYNC_POWERUP)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_WAIT_ASYNC_POWERUP (
-  IN PVOID BusContext);
+USB_BUSIFFN_WAIT_ASYNC_POWERUP(
+  _In_ PVOID BusContext);
 typedef USB_BUSIFFN_WAIT_ASYNC_POWERUP *PUSB_BUSIFFN_WAIT_ASYNC_POWERUP;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_GET_DEVICE_ADDRESS)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_GET_DEVICE_ADDRESS (
-  IN PVOID BusContext,
-  IN PUSB_DEVICE_HANDLE DeviceHandle,
-  OUT PUSHORT DeviceAddress);
+USB_BUSIFFN_GET_DEVICE_ADDRESS(
+  _In_ PVOID BusContext,
+  _In_ PUSB_DEVICE_HANDLE DeviceHandle,
+  _Out_ PUSHORT DeviceAddress);
 typedef USB_BUSIFFN_GET_DEVICE_ADDRESS *PUSB_BUSIFFN_GET_DEVICE_ADDRESS;
 
-typedef
-VOID
+_Function_class_(USB_BUSIFFN_DEREF_DEVICE_HANDLE)
+typedef VOID
 USB_BUSIFFN
-USB_BUSIFFN_DEREF_DEVICE_HANDLE (
-  IN PVOID BusContext,
-  IN PUSB_DEVICE_HANDLE DeviceHandle,
-  IN PVOID Object,
-  IN ULONG Tag);
+USB_BUSIFFN_DEREF_DEVICE_HANDLE(
+  _In_ PVOID BusContext,
+  _In_ PUSB_DEVICE_HANDLE DeviceHandle,
+  _In_ PVOID Object,
+  _In_ ULONG Tag);
 typedef USB_BUSIFFN_DEREF_DEVICE_HANDLE *PUSB_BUSIFFN_DEREF_DEVICE_HANDLE;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_REF_DEVICE_HANDLE)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_REF_DEVICE_HANDLE (
-  IN PVOID BusContext,
-  IN PUSB_DEVICE_HANDLE DeviceHandle,
-  IN PVOID Object,
-  IN ULONG Tag);
+USB_BUSIFFN_REF_DEVICE_HANDLE(
+  _In_ PVOID BusContext,
+  _In_ PUSB_DEVICE_HANDLE DeviceHandle,
+  _In_ PVOID Object,
+  _In_ ULONG Tag);
 typedef USB_BUSIFFN_REF_DEVICE_HANDLE *PUSB_BUSIFFN_REF_DEVICE_HANDLE;
 
-typedef
-ULONG
+_Function_class_(USB_BUSIFFN_SET_DEVICE_HANDLE_IDLE_READY_STATE)
+typedef ULONG
 USB_BUSIFFN
-USB_BUSIFFN_SET_DEVICE_HANDLE_IDLE_READY_STATE (
-  IN PVOID BusContext,
-  IN PUSB_DEVICE_HANDLE DeviceHandle,
-  IN ULONG NewIdleReadyState);
+USB_BUSIFFN_SET_DEVICE_HANDLE_IDLE_READY_STATE(
+  _In_ PVOID BusContext,
+  _In_ PUSB_DEVICE_HANDLE DeviceHandle,
+  _In_ ULONG NewIdleReadyState);
 typedef USB_BUSIFFN_SET_DEVICE_HANDLE_IDLE_READY_STATE *PUSB_BUSIFFN_SET_DEVICE_HANDLE_IDLE_READY_STATE;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_GET_CONTAINER_ID_FOR_PORT)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_GET_CONTAINER_ID_FOR_PORT (
-  IN PVOID BusContext,
-  IN USHORT PortNumber,
-  OUT LPGUID ContainerId);
+USB_BUSIFFN_GET_CONTAINER_ID_FOR_PORT(
+  _In_ PVOID BusContext,
+  _In_ USHORT PortNumber,
+  _Out_ LPGUID ContainerId);
 typedef USB_BUSIFFN_GET_CONTAINER_ID_FOR_PORT *PUSB_BUSIFFN_GET_CONTAINER_ID_FOR_PORT;
 
-typedef
-VOID
+_Function_class_(USB_BUSIFFN_SET_CONTAINER_ID_FOR_PORT)
+typedef VOID
 USB_BUSIFFN
-USB_BUSIFFN_SET_CONTAINER_ID_FOR_PORT (
-  IN PVOID BusContext,
-  IN USHORT PortNumber,
-  IN LPGUID ContainerId);
+USB_BUSIFFN_SET_CONTAINER_ID_FOR_PORT(
+  _In_ PVOID BusContext,
+  _In_ USHORT PortNumber,
+  _In_ LPGUID ContainerId);
 typedef USB_BUSIFFN_SET_CONTAINER_ID_FOR_PORT *PUSB_BUSIFFN_SET_CONTAINER_ID_FOR_PORT;
 
-typedef
-NTSTATUS
+_Function_class_(USB_BUSIFFN_ABORT_ALL_DEVICE_PIPES)
+typedef NTSTATUS
 USB_BUSIFFN
-USB_BUSIFFN_ABORT_ALL_DEVICE_PIPES (
-  IN PVOID BusContext,
-  IN PUSB_DEVICE_HANDLE DeviceHandle);
+USB_BUSIFFN_ABORT_ALL_DEVICE_PIPES(
+  _In_ PVOID BusContext,
+  _In_ PUSB_DEVICE_HANDLE DeviceHandle);
 typedef USB_BUSIFFN_ABORT_ALL_DEVICE_PIPES *PUSB_BUSIFFN_ABORT_ALL_DEVICE_PIPES;
 
 #define ERRATA_FLAG_RESET_TT_ON_CANCEL              1
@@ -425,13 +431,13 @@ typedef USB_BUSIFFN_ABORT_ALL_DEVICE_PIPES *PUSB_BUSIFFN_ABORT_ALL_DEVICE_PIPES;
 
 #define USB_BUSIF_HUB_SS_VERSION_0      0x0000
 
-typedef
-VOID
+_Function_class_(USB_BUSIFFN_SET_DEVICE_ERRATA_FLAG)
+typedef VOID
 USB_BUSIFFN
-USB_BUSIFFN_SET_DEVICE_ERRATA_FLAG (
-  IN PVOID BusContext,
-  IN PUSB_DEVICE_HANDLE DeviceHandle,
-  IN ULONG DeviceErrataFlag);
+USB_BUSIFFN_SET_DEVICE_ERRATA_FLAG(
+  _In_ PVOID BusContext,
+  _In_ PUSB_DEVICE_HANDLE DeviceHandle,
+  _In_ ULONG DeviceErrataFlag);
 typedef USB_BUSIFFN_SET_DEVICE_ERRATA_FLAG *PUSB_BUSIFFN_SET_DEVICE_ERRATA_FLAG;
 
 DEFINE_GUID(USB_BUS_INTERFACE_HUB_GUID,