Lucent Technologies USS-720 manual Ioctlreadinterruptpipe, Byte Description

Ad

Page 84

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

4 I/O Control Codes (continued)

4.17 IOCTL_READ_INTERRUPT_PIPE

IOCTL_READ_INTERRUPT_PIPE reports changes on the parallel port and buffer status when they occur. Details regarding parameters and error codes follow.

4.17.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 four status bytes reﬂecting changes in the parallel port and buffer status as follows (see the USS-720USB-to-IEEE 1284 Bridge Preliminary Data Sheet, “Registers”):

Byte	Description

0Status.

1Control.

2Extended control.

3USS-720 control.

nOutBufferSize—Speciﬁes the size (in bytes) of the buffer pointed to by lpOutBuffer, which must be large enough to contain 4 bytes.

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

4.17.2 Notes

None.

4.17.3 Error Codes

ERROR_INVALID_ALTERNATESETTING—The command is only supported in ALT_INTERFACE_2 (see Section 4.9 of this document).

ERROR_NOT_ENOUGH_BUFFER—lpOutBuffer needs to be large enough to receive the status bytes.

STATUS_INSUFFICIENT_RESOURCES—Not enough memory to perform the request on this device instance.

7-26	Lucent Technologies Inc.

Image 84

Contents Introduction Information Manual, Rev SeptemberTable of Contents Information Manual, Rev Evaluation Kit for USS-720 September USB-to-IEEE BridgeUSS-720 USB Device Driver Preliminary User Guide IOCTL1284 TerminateIOCTLSET1284REGISTER 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 InstructionsUSB Driver and Port Monitor Plug and PlayPort 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.SYS USS720.INFDocumentation USS-720 Software Use Agreement February Software Components Application Note, Rev FebruaryCustomer-Deﬁned Data Plug and Play Operation PnPPrinter Enumeration Power Management Installation ProcessOperating Systems Supported USB Hardware Types SupportedPrinter Types Supported Print Types SupportedFeatures Preliminary Data Sheet, Rev SeptemberDescription Table of Contents Preliminary Data Sheet, Rev USS-720 Pin InformationUSB-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 LocationsUSB-to- Ieee 1284 Bridge September Onboard Device DescriptorDevice Descriptor Offset Field Size Value Description USB-to- Ieee Conﬁguration DescriptorInterface Descriptors Bulk Out Endpoint Descriptor, I0A0E1September USB-to-IEEE1284 Bridge Bulk Out Endpoint Descriptor, I0A1E1Bulk In Endpoint Descriptor, I0A1E2 Bulk Out Endpoint Descriptor, I0A2E1 Bulk In Endpoint Descriptor, I0A2E2Interrupt Endpoint Descriptor, I0A2E3 Pipes RequestsStandard Requests Printer Class-Speciﬁc Requests Get Port Status Data Bit DescriptionVendor-Speciﬁc Requests GET1284REGISTERSET1284REGISTER Ieee 1284 Port Register-Based OperationRegisters GET1284REGISTER Data Byte Register DataInterrupt Pipe Read Data Byte Register DataStatus Register Address Bit Symbol Default Bit Symbol Bit DescriptionParallel 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 ClkhiTiming Characteristics Setup and Hold Input Timing ParameterOutput 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