Lucent Technologies USS-720 manual Ioctlgetdeviceinstances

Page 80

USS-720	Preliminary User Guide, Rev. 2
USB Device Driver	February 1999

4 I/O Control Codes (continued)

4.13 IOCTL_GET_DEVICE_INSTANCES

IOCTL_GET_DEVICE_INSTANCES returns a list of current devices based on the symbolic links created during each device enumeration. Details regarding parameters and error codes follow.

4.13.1 Parameters

lpInBuffer—Points to an input buffer that will receive. Not used with this operation. Set to NULL.

nInBufferSize—Speciﬁes 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 DEVICE_INSTANCE_HEADER structure (see Section 5.1) and a series of DEVICE_INSTANCE structures (see Section 5.2), one for each device instance.

nOutBufferSize—Speciﬁes the size (in bytes) of the buffer pointed to by lpOutBuffer. 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.13.2 Notes

None.

4.13.3 Error Code

ERROR_NOT_ENOUGH_BUFFER—lpOutBuffer needs to be large enough to receive the device instances.

7-22	Lucent Technologies Inc.

Image 80

Contents Introduction Information Manual, Rev SeptemberTable of Contents Information Manual, Rev Evaluation Kit for USS-720 September USB-to-IEEE BridgeIOCTLSET1284REGISTER USS-720 USB Device Driver Preliminary User GuideIOCTL1284 Terminate USS-720 USB Port Monitor Application Note Evaluation Kit Contents Hardware Requirements \SAMPLESOSR2.1 Cable Installation Instructions Getting Started InstructionsSoftware Updates Windows 98 Cable Installation InstructionsPort Creation USB Driver and Port MonitorPlug and Play Eeprom Lucent Technologies Inc Lucent Technologies Microelectronics Group In-System Design, IncUSB Applications Support September Evaluation Kit Software USS-720 Driver Software Object Code License AgreementFebruary IntroductionUSS-720 Software Use Agreement February Licensed SoftwareFurnishing of Licensed Software OwnershipUSS-720 February Software Use AgreementWarranty and Indemnity Agreement PrevailsNothing Construed 04 ConﬁdentialityPublicity NonassignabilityAddresses IntegrationApplicable Law DisputesDocumentation USS720.SYSUSS720.INF USS-720 Software Use Agreement February Software Components Application Note, Rev FebruaryPrinter Enumeration Customer-Deﬁned DataPlug and Play Operation PnP Power Management Installation ProcessOperating Systems Supported USB Hardware Types SupportedPrinter Types Supported Print Types SupportedDescription FeaturesPreliminary Data Sheet, Rev September Table of Contents USB-to-IEEE Preliminary Data Sheet, Rev USS-720Pin Information Parallel Port nAutoFd Signal Active-Low Parallel Port nSelectIn Signal Active-LowParallel Port nInit Signal Active-Low Parallel Port nAck Signal Active-LowOverview USB PortDevice Descriptor, Conﬁgurations, and Inter- faces Descriptor LocationsDevice Descriptor Offset Field Size Value Description USB-to- Ieee 1284 Bridge SeptemberOnboard Device Descriptor USB-to- Ieee Conﬁguration DescriptorInterface Descriptors Bulk Out Endpoint Descriptor, I0A0E1Bulk In Endpoint Descriptor, I0A1E2 September USB-to-IEEE1284 BridgeBulk Out Endpoint Descriptor, I0A1E1 Interrupt Endpoint Descriptor, I0A2E3 Bulk Out Endpoint Descriptor, I0A2E1Bulk In Endpoint Descriptor, I0A2E2 Standard Requests PipesRequests Printer Class-Speciﬁc Requests Get Port Status Data Bit DescriptionSET1284REGISTER Vendor-Speciﬁc RequestsGET1284REGISTER Ieee 1284 Port Register-Based OperationRegisters GET1284REGISTER Data Byte Register DataInterrupt Pipe Read Data Byte Register DataParallel Port nFault Signal Reserved Status Register Address Bit SymbolDefault Bit Symbol Bit Description Control Register Address Bit Symbol Access Default Bit Symbol Bit DescriptionParallel Port nInit Signal USB-to-IEEE1284 BridgeUSS-720Instant USB ECP Command Register Address Bit Symbol Access Extended Control Register Address Bit Symbol Mode20 DescriptionUSS-720 Control Register Address Bit Symbol USS-720 Setup Register Address Bit Symbol Interrupts External Circuitry Requirements External Crystal ConnectionFilter Bypass Mode High Drive ModeSelf-Powered Mode Absolute Maximum Ratings Parameter Symbol Min UnitElectrical Characteristics Parameter Symbol Test Conditions Min Typ Max UnitCapacitance Values Parameter Unit Clklo ClkhiOutput Delay Timing Parameter Min Max Unit Timing CharacteristicsSetup and Hold Input Timing Parameter Outline Diagram Ordering InformationPin Mqfp Device Code Package ComcodeApplication Note February Description Parallel PortBridging USB to Typical Circuit Showing USSLucent Technologies Inc Signal Directions Preliminary User Guide, Rev FebruaryIOCTL1284 Setmode Initialization O File FunctionsPreliminary User Guide, Rev USS-720 February USB Device DriverCreateFile Error Codes ReadFileWriteFile DeviceIoControl CloseHandle O Control Codes Control Code DescriptionIOCTL1284 Ecpfwdtorev ParametersIOCTL1284ECPREVTOFWD IOCTL1284 Ecpsetchannel Register Mode Description IOCTL1284 SetmodeIOCTL1284 Terminate Ioctlabortpipe Value DescriptionBulkoutpipe BulkinpipeIoctlcancelpiperequest IOCTLGET1284REGISTER Ioctlgetaltsetting ALTINTERFACE0ALTINTERFACE1 ALTINTERFACE2Ioctlgetcapabilities Ioctlgetconfigurationdescriptor Ioctlgetdevicedescriptor Ioctlgetdeviceinstances Ioctlgetinterface Ioctlgetportstatus Bit MeaningIOCTLISSUEUSS720COMMAND Command DescriptionIoctlreadinterruptpipe Byte DescriptionIoctlresetpipe IOCTLSET1284REGISTER Ioctlsetaltsetting Ioctlsoftreset O Control Data Structures DeviceinstanceheaderDeviceinstance Data StructureREGISTER1284 REGISTER1284, *PREGISTER1284ADVREGISTER1284 ADVREGISTER1284, *PADVREGISTER1284Lucent Technologies Inc USS-720 USB Port Monitor USS-720 Application Note USB Port Monitor February Printer Cable with Instant USBSoftware Installation Instructions W98USS720EvalKit2402.zip to download the installation ﬁlesApplication Note June Click on Enter LibrarySeptember MN99-052CMPR-1 Replaces MN97-061CMPR-04