pinvoke.net: Edit: Structures.USB_NODE_CONNECTION_INFORMATION

@msdn=http://search.microsoft.com/search/results.aspx?qu=$$$
@pinvoke=http://pinvoke.net/$$$.htm

Summary: Used with DeviceIoControl and [IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX] to retrieve information about a port connection on a USB Hub

!!!!C# Definition:
 [StructLayout(LayoutKind.Sequential, Pack=1)]
 struct USB_NODE_CONNECTION_INFORMATION_EX
 {
   public int ConnectionIndex;
   public USB_DEVICE_DESCRIPTOR DeviceDescriptor;
   public byte CurrentConfigurationValue;
   public byte Speed;
   public byte DeviceIsHub;
   public short DeviceAddress;
   public int NumberOfOpenPipes;
   public int ConnectionStatus;
   //public IntPtr PipeList;
 }
!!!!VB Definition:
 Structure USB_NODE_CONNECTION_INFORMATION_EX 
   Public TODO
 End Structure
!!!!User-Defined Field Types:
None.

!!!!Notes:
The use of a zero-length array at the end of the structure makes using this in C#/VB.Net a bit tricky.  You should allways allocate sufficient buffer space beyond the true size of the structure.  The use of "pack=1" may be required to accurately find the "end" of the structure where the unmanaged buffer starts.

typedef struct _USB_NODE_CONNECTION_INFORMATION_EX {
   ULONG  ConnectionIndex;
   USB_DEVICE_DESCRIPTOR  DeviceDescriptor;
   UCHAR  CurrentConfigurationValue;
   UCHAR  Speed;
   BOOLEAN  DeviceIsHub;
   USHORT  DeviceAddress;
   ULONG  NumberOfOpenPipes;
   USB_CONNECTION_STATUS  ConnectionStatus;
   USB_PIPE_INFO  PipeList[0];
 } USB_NODE_CONNECTION_INFORMATION_EX, *PUSB_NODE_CONNECTION_INFORMATION_EX;

I've added a work around for this below.

Documentation: USB_NODE_CONNECTION_INFORMATION_EX@msdn on MSDN

!!!!Example:
 // Open a handle to the Hub device
 IntPtr h = CreateFile(HubDevicePath, GENERIC_WRITE, FILE_SHARE_WRITE, IntPtr.Zero, OPEN_EXISTING, 0, IntPtr.Zero);
 if (h.ToInt32() != INVALID_HANDLE_VALUE)
 {
   int nBytes = Marshal.SizeOf(typeof(USB_NODE_CONNECTION_INFORMATION_EX));
   IntPtr ptrNodeConnection = Marshal.AllocHGlobal(nBytes);

// loop thru all of the ports on the hub
   // BTW: Ports are numbered starting at 1
   for (int i = 1; i <= HubPortCount; i++)
   {
     int nBytesReturned;
     USB_NODE_CONNECTION_INFORMATION_EX NodeConnection = new USB_NODE_CONNECTION_INFORMATION_EX();
     NodeConnection.ConnectionIndex = i;
     Marshal.StructureToPtr(NodeConnection, ptrNodeConnection, true);

if (DeviceIoControl(h, IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX, ptrNodeConnection, nBytes, ptrNodeConnection, nBytes, out nBytesReturned, IntPtr.Zero))
     {
       NodeConnection = (USB_NODE_CONNECTION_INFORMATION_EX)Marshal.PtrToStructure(ptrNodeConnection, typeof(USB_NODE_CONNECTION_INFORMATION_EX));
       // do something here...
     }
   }
   Marshal.FreeHGlobal(ptrNodeConnection);
   CloseHandle(h);
 }

!!!!Example:
 // To get the USB_PIPE_INFO data
 for (int i = 0; i < HubPortCount; i++)
 {
   USB_NODE_CONNECTION_INFORMATION_EX connection = new USB_NODE_CONNECTION_INFORMATION_EX();
   connection.ConnectionIndex = i;
   size = Marshal.SizeOf(typeof(USB_NODE_CONNECTION_INFORMATION_EX)) + 32 * Marshal.SizeOf(typeof(USB_PIPE_INFO)); // Assuming 32 should be enough, you can make this larger

IntPtr ptr_connection = Marshal.AllocHGlobal(size);
   Marshal.StructureToPtr(connection, ptr_connection, true);

int bytes_returned;
   if (DeviceIoControl(hHub, IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX, ptr_connection, size, ptr_connection, size, out bytes_returned, IntPtr.Zero))
   {
     connection = (USB_NODE_CONNECTION_INFORMATION_EX)Marshal.PtrToStructure(ptr_connection, typeof(USB_NODE_CONNECTION_INFORMATION_EX));

if (bytes_returned != Marshal.SizeOf(typeof(USB_NODE_CONNECTION_INFORMATION_EX)))
     {
       IntPtr ptr_pipeinfo;

int num = (bytes_returned - Marshal.SizeOf(typeof(USB_NODE_CONNECTION_INFORMATION_EX))) / Marshal.SizeOf(typeof(USB_PIPE_INFO));
       USB_PIPE_INFO[] pipe_info = new USB_PIPE_INFO[num];

for (int j = 0; j < num; j++)
       {
         // Set ptr to an USB_PIPE_INFO element and marshal it back
         IntPtr ptr_pipeinfo = new IntPtr((byte*)ptr_connection.ToPointer() 
                                           + Marshal.SizeOf(typeof(USB_NODE_CONNECTION_INFORMATION_EX)) 
                                           + j * Marshal.SizeOf(typeof(USB_PIPE_INFO)));
         pipe_info[j] = (USB_PIPE_INFO)Marshal.PtrToStructure(ptr_pipeinfo, typeof(USB_PIPE_INFO));
       }
     }
   }

Marshal.FreeHGlobal(ptr_connection);
 }