Lucent Technologies USS-720 manual Ioctlgetaltsetting, ALTINTERFACE0, ALTINTERFACE1, ALTINTERFACE2

Page 76

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

4 I/O Control Codes (continued)

4.9 IOCTL_GET_ALTSETTING

IOCTL_GET_ALTSETTING retrieves the current alternate interface setting from the USS-720 device. Details regarding parameters and error codes follow.

4.9.1 Parameters

lpInBuffer—Points to an input buffer. 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 single byte indicating the current alternate setting based on one of the following:

Value	Description

ALT_INTERFACE_0	Bulk Out pipe only.

ALT_INTERFACE_1	Bulk Out and Bulk In pipe.

ALT_INTERFACE_2	Bulk Out, Bulk In, Interrupt pipe, and 1284 register capabilities.

nOutBufferSize—Speciﬁes the size (in bytes) of the buffer pointed to by lpOutBuffer. The buffer must be large enough to contain one byte value.

lpBytesReturned—Points to a DWORD that receives the actual size (in bytes) of the data stored into lpOutBuffer.

4.9.2 Notes

None.

4.9.3 Error Code

ERROR_NOT_ENOUGH_BUFFER—lpOutBuffer needs to be large enough to contain one byte value.

7-18	Lucent Technologies Inc.

Image 76

Contents Introduction Information Manual, Rev SeptemberTable of Contents Information Manual, Rev Evaluation Kit for USS-720 September USB-to-IEEE BridgeIOCTL1284 Terminate USS-720 USB Device Driver Preliminary User GuideIOCTLSET1284REGISTER 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 InstructionsPlug and Play USB Driver and Port MonitorPort Creation 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 DisputesUSS720.INF USS720.SYSDocumentation USS-720 Software Use Agreement February Software Components Application Note, Rev FebruaryPlug and Play Operation PnP Customer-Deﬁned DataPrinter Enumeration Power Management Installation ProcessOperating Systems Supported USB Hardware Types SupportedPrinter Types Supported Print Types SupportedPreliminary Data Sheet, Rev September FeaturesDescription Table of Contents Pin Information Preliminary Data Sheet, Rev USS-720USB-to-IEEE 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 LocationsOnboard Device Descriptor USB-to- Ieee 1284 Bridge SeptemberDevice Descriptor Offset Field Size Value Description USB-to- Ieee Conﬁguration DescriptorInterface Descriptors Bulk Out Endpoint Descriptor, I0A0E1Bulk Out Endpoint Descriptor, I0A1E1 September USB-to-IEEE1284 BridgeBulk In Endpoint Descriptor, I0A1E2 Bulk In Endpoint Descriptor, I0A2E2 Bulk Out Endpoint Descriptor, I0A2E1Interrupt Endpoint Descriptor, I0A2E3 Requests PipesStandard Requests Printer Class-Speciﬁc Requests Get Port Status Data Bit DescriptionGET1284REGISTER Vendor-Speciﬁc RequestsSET1284REGISTER Ieee 1284 Port Register-Based OperationRegisters GET1284REGISTER Data Byte Register DataInterrupt Pipe Read Data Byte Register DataDefault Bit Symbol Bit Description Status Register Address Bit SymbolParallel Port nFault Signal Reserved 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 ClkhiSetup and Hold Input Timing Parameter Timing CharacteristicsOutput Delay Timing Parameter Min Max Unit 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