Preliminary User Guide, Rev. 2 USS-720
February 1999 USB Device Driver
Lucent Technologies Inc. 7-23
13
4 I/O Control Codes (continued)
4.14 IOCTL_GET_INTERFACE
IOCTL_GET_INTERFACE gets the information about the current interface and pipes. Details regarding parameters
and error codes follow.
4.14.1 Parameters
lpInBuffer—Points to an input buffer. Not used with this operation. Set to NULL.
nInBufferSize—Specifies the size (in bytes) of the buffer pointed to by lpInBuffer. Not used with this operation. Set
to zero.
lpOutBuffer—Points to an output buffer that will receive a USBD_INTERFACE_INFORMATION data structure (see
WDM USB Driver Specification
).
nOutBufferSize—Specifies the size (in bytes) of the buffer pointed to by lpOutBuffer, which must be large enough to
contain the USBD_INTERFACE_INFORMATION data structure. Specify zero to return only the length of the
Device ID string in lpBytesReturned.
lpBytesReturned—Points to a DWORD that receives the actual size (in bytes) of the data stored into lpOutBuffer.
4.14.2 Notes
None.
4.14.3 Error Code
ERROR_NOT_ENOUGH_BUFFER—lpOutBuffer needs to be large enough to receive the interface information.