beautypg.com

14 ioctl_get_interface, 1 parameters, 2 notes – Lucent Technologies USS-720 User Manual

Page 81: 3 error code

background image

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.