WINSOCK和QOS（英文）

Acknowledgements

Part 1

Chapter 1: Getting Around in the NetWorking Services Library

How the NetWorking Services Library Is Structured

How the Networking Services Library Is Designed

Chapter 2: What’s In This VoIume?

Winsock

QuaIity of Service

Chapter 3: Using Microsott Reference Resources

The Microsott DeveIoper NetWork

Comparing MSDN with MSDN OnIine

MSDN Subscriptions

MSDN Library Subscription

MSDN Professional Subscription

MSDN UniversaI Subscription

Purchasing an MSDN Subscription

Using MSDN

Navigating MSDN

Quick Tips

Using MSDN OnIine

Navigating MSDN Online

MSDN Online Features

MSDN Online Registered Users

The Windows Programming Reference Series

Chapter 4: Finding the DeveIoP6r Resources You Need

Developer Support

OnIine Resources

lnternet Standards

Learning Products

Conferences

Other Resources

Chapter 5: Writing Great IrDA AppIications (with Winsock)

What ls an Ad-Hoc NetWorking-EnabIed Application?

What ls lrDA?

What ls lrDA-C (PreviOusly Known as lrBus)?

What ls Unique about IrDA?

IrDA Core ProtocoIs and Services

SeriaI lrDA (SIR) PhysicaI Layer (115 Kb/s)

Fast irDA (FIR) PhysicaI Layer (4 Mb/s)

IrLAP Data Link Layer

lrLMP and TinyTP

lrCOMM

lrCOMM Modes

No IrCOMM VirtuaI SeriaI Ports on Windows 2000

Windows 2000 Support for IrCOMM Through Winsock

IrDA and the Windows Sockets APl

TaIking to Non-Windows Devices

AppIication AddreSsing

Data Transfer and Connection Close

lrDA and Winsock Reference

WSAStartup

af irdah

socket

SOCKADDR--IRDA Structure

bind

listen

accept

send and recv

cIosesocket

getsockopt(,, lRLMP__ENUMDEVICES,,) and connect()

IAS

IrCOMM Client

Windows 2000 lrDA Architecture

IrDA Hardware Drivers

Windows 2000 Multiple-Adapter Support

Part 2

ChaPter 6: Winsock 2 APl 0veFView

WeIcome to Windows Sockets 2

Using the Windows Sockets 2 API Document

Overview of Windows Sockets 2

Windows Sockets 2 Features

Conventions for New Functions

Microsott Extensions and the Windows Sockets 2 API

Socket Handles for Windows Sockets 2

New Concepts, Additions, and Changes for Windows Sockets 2

Windows Sockets 2 Architecture

Simultaneous Access to MultipIe Transport Protocols

Backward Compatibility for Windows Sockets 1.1 AppIications

Making Transport ProtocoIs AvailabIe to Windows Sockets

Layered Protocols and ProtocoI Chains

Using MuItipIe Protocols

MultipIe Provider Restrictions on SeIect

Function EXtension Mechanism

Debug and Trace FaciIities

Name ResoIution

OverIapped I/O and Event Objects

Event Objects

Receiving CompIetion lndications

Asynchronous Notification Using Event ObjeCts

Flow Specification QuaIity of Service

QOS TempIates

Default VaIues

Socket Groups

Shared Sockets

Enhanced FunCtionality During Connection Setup and Teardown

EXtended Byte-Order Conversion Routines

Support for Scatter/Gather l/O in the APl

ProtocoI-lndependent Multicast and Multipoint

Summary of New Socket Options

Summary of New Socket loctl Opcodes

Summary of New Functions

Windows Sockets Programming Considerations

Deviation from BerkeIey Sockets

Socket Data Type

SeIect and FD *

Error Codes--errno, h_errno and WSAGetLastError

Pointers

Renamed Functions

Maximum Number of Sockets Supported

IncIude FiIes

Retum VaIues on Function Failure

Service Provided Raw Sockets

Byte Ordering

Windows Sockets Compatibility Issues

Default State for a Socket’s OverIapped Attribute

Windows Sockets 1 1 Blocking Routines and ElNPROGRESS

GracefuI Shutdown, Linger Options, and Socket Closure

PrOtocoI-Independent Out-of-Band Data

Summary of Windows Sockets 2 Functions

Socket Functions

Microsott Windows-Specific EXtension Functions

Registration and Name Resolution

Protocol-lndependent Name Resolution

Name ResoIution ModeI

Summary of Name ResoIution Functions

Name Resolution Data Structures

Compatible Name ResoIution for TCP/lP in the Windows Sockets 1.1

Basic Approach for GetXbyY in the APl

getprotobyname and getprotobynumber Functions in the APl

getservbyname and getservbyPort Functions in the API

gethostbyname Function in the APl

gethostbyaddr FunCtion in the API

gethostname Function in the API

Multipoint and MuIticast Semantics

Multipoint Taxonomy

Windows Sockets 2 lnterface EIements for MuItipoint and MuIticast

Attributes in WSAPROTOCOL INFO Structure

Flag Bits for WSASocket

SIO MULTIPOlNT LOOPBACK Command Code for WSAIoCtI

SIO MULTlCAST SCOPE Command Code for WSAloctI

Semantics for Joining Multipoint Leaves

Using WSAJoinLeaf

Semantic Differences Between Multipoint Sockets and Regular Sockets

How Existing Multipoint Protocols Support These EXtensions

IP MuIticast

ATM Point to MuItipoint

AdditionaI Windows Socket Information

Windows Sockets 2 API Header FiIe--Winsock2h

Socket Options Specific to Microsoft Service Providers

Socket Qption for Windows NT 40 Only

Socket Option for Windows NT 40 and Windows 95

AdditionaI Documentation

Chapter 7: Error Codes in the Winsock API

Error Codes

Chapter 8: Winsock 2 Functions

Windows Sockets 2 Functions

Chapter 9: Winsock 2 Structures and Enumerations

Windows Sockets Structures in the APl

Windows Sockets Enumeration in the APl

Chapter 10: Winsock 2 SPl Overview

Welcome to Windows Sockets 2 SPI

Using the SPI Document

Overview of the Windows Sockets 2 SPI

Windows Sockets 2 SPl Features

Microsott Extensions and the Windows Sockets 2 SPI

Socket Handles for the Windows Sockets 2 SPI

Windows Sockets 2 Architectural Overview

Windows Sockets 2 as a WOSA Component

Windows Sockets 2 DLLs

Function lnterface Model

Naming Conventions

Windows Sockets 2 Service Providers

Transport Service Providers

Namespace Service Providers

Windows Sockets 2 Identifiers

Data Transport Providers

Transport Division of ResponsibiIities Between DLL and Service ProviI

Transport Mapping Between APl and SPI Functions

FunCtion Extension Mechanism in the SPl

Transport Configuration and InstaIIation

Name Resolution Providers

Name Resolution ModeI for the SPI

Name Resolution Division of ResponsibiIities BetWeen DLL and ServiI

Providers

Name Resolution Mapping BetWeen API and SPI Functions

Name Resolution Configuration and InstaIlation

Windows Sockets 2 Transport Provider Requirements

Service Provider Activation

Initialization

CIeanup

Error Reporting and Parameter Validation

Byte Ordering Assumptions

Socket Creation and Descriptor Management

Descriptor AIlocation

Socket Attribute FIags and Modes

Closing Sockets

BIocking Operations

Pseudo vsrue Blocking

BIocking Hook

CanceIing BIocking Operations

Event Objects in the Windows Sockets 2 SPI

Creating Event Objects

Using Event Objects

Destroying Event Objects

Notification of NetWork Events

Selects

Windows Messages

Event ObjeCt Signaling

Socket Groups in the Windows Sockets 2 SPl

Socket Group Operations

Required Socket Grouping Behavior

Recommended Socket Grouping Behavior

QuaIity of Service in the Windows Sockets 2 SPI

Socket Connections on Connection-Oriented Protocols

Binding to a Local Address

ProtocoI Basics:Listen, Connect, Accept

Determining LocaI and Remote Names

Enhanced FunctionaIity at Connect Time

Connection Shutdown

Socket Connections on Connectionless ProtocoIs

Connecting to a DefauIt Peer

Reconnecting and Disconnecting

Using Sendto While Connected

Socket l/O

BIocking InpuVOutput

NonbIocking Input/Output

Overlapped InpuVOutput

Support for Scatter/Gather lnpuhOutput in the SPI

Out-of-Band Data in the SPI

Shared Sockets in the SPl

MultipIe HandIes to a SingIe Socket

Reference Counting

Precedence Guidelines

ProtocoI-lndependent Multicast and MuItipoint in the SPI

MuItipoint Taxonomy and GIossary

MuItipoint Attributes in the WSAPROTOCOLlNFOW Structure

MuItipoint Socket Attributes

SlO--MULTlPOlNT--LOOPBACK loctl

SIO--MULTICAST--SCOPE IoctI

SPl Semantics for Joining Multipoint Leaves

Using WSPJoinLeaf

Semantic Differences Between MuItipoint Sockets and ReguIar Sockl

in the SPI

Socket Options and lOCTLs

Summary of Socket loctl Opcodes

Summary of SPl Functions

Generic Data Transport Functions

UpcaIIs Exposed by Windows Sockets 2 DLL

lnstaIIation and Configuration Functions

Name Resolution Service Provider Requirements

Summary of Namespace Provider Functions

Namespace Provider Configuration and lnstaIIation

Namespace Provider l nitiaIization and CIeanup

Service InstaIIation in the Windows Sockets 2 SPI

Service’Query

Helper Functions in the SPI

Name ResoIution Data Structures in the SPI

Compatible Name ResoIution for TCP/IP in the Windows Sockets 1.1 SPl

Basic Approach for getXbyY in the SPI

getprotobyname and getprotobynumber Functions in the SPl

getservbyname and getservbyport Functions in the SPI

gethostbyname Function in the SPI

gethostbyaddr Function in the SPl

gethostname Function in the SPI

SampIe Code for a Service Provider

AdditionaI Windows Sockets 2 SPI Concerns

Service Provider Ordering

Windows Sockets SPl Header FiIe - Ws2spih

Chapter 11: Winsock 2 SPI Reference

Winsock 2 SPl Reference

Chapter 12: Winsock 2 Protocol-Specific Annex

Using the Annex

Overview of Windows Sockets 2

Microsott EXtensions and Windows Sockets 2

Socket HandIes for Windows Sockets 2

TCP/IP

TCP/IP Introduction

TCP/IP Overview

TCP/IP Data Structures

TCP/IP ControIs

UNIX Ioctfs

TCP/IP Socket Options

TCP/IP Function Details

MuIticast

TCP/IP Raw Sockets

lPv6 Support

TeXt Representation of IPv6 Addresses

TCP/lP Header FiIe

IPWSPX

lPX/SPX Introduction

IPX/SPX Overview

AF--lPX Address Family

lPX Family of Protocol ldentifiers

Broadcast to LocaI NetWork

AIl Routes Broadcast

Directed Broadcast

About Media Packet Size

How Packet Size Affects ProtocoIs

lPX/SPX Data Structures

lPX/SPX ControIs

NSPROTO--lPX Socket Options

DECnet Overview

DNPROTO--NSP Protocol Family

AF--DECnet Addres& Families

SOCKSEQPACKET Socket Type

DECnet Data Structures

Manifest Constants (Winsock2h)

Manifest Constants (Ws2dneth)

Data Structures (Ws2dneth)

DECnet Function DetaiIs

Connections Using Accept/WSAAccept/WSPAccept

Structure Information for Bind/WSPBind

Connections Using Connect/WSAConnect/WSPConnect

Addressing with GetPeerName/WSPGetPeerName

Receiving Local Name with getsocknameMSPGetSockName

Using Getsockopt/WSPGetSockOpt

Using SocketwSASocket/WSPSocket

DECnet Out-of-Band Data

DECnet-Specific Extended Functions Identifiers

dnet--addr

dneteof

dnet--getacc

dnetgetalias

dnet--htoa

dnet--ntoa

getnodeadd

getnodebyaddr

getnodebyname

getnodename

DECnet Header FiIe

Open Systems lnterconnection (OSl)

OSl lntroduction

lnternationaI Organization for Standardization (IOS)

OSl Expedited Data

ISO Qualified Data

ISO Reset

OSI QuaIity of Service

Option Profiles

Address Format

OSI D8ta Structures

OSl Controls

Ioctls

Socket Options

OSl Function Specifics

QuaIity of Service

OSI Header File

ATM-Specific EXtensions

ATM lntroduction

ATM Overview

ATM Data Structures

Using the ATM--ADDRESS Structure

ATM BLLl Structure and Associated Manifest Constants

ATM--BHLl Structure and Associated Manifest Constants

ATM ControIs

ATM Function Specifics

ATM-Specific QuaIity of Service EXtension

AAL Parameters

ATM Traffic Descriptor

Broadband Bearer CapabiIity

Broadband High Layer lnformation

Broadband Lower Layer lnformation

CaIIed Party Number

CaIled Party Subaddress

CalIing Party Number

Calling Party Subaddress

QuaIity of Service Parameter

Transit NetWork SeIection Cause

ATM Header File

Other Windows Sockets 2 Considerations

Secure Sockets Layer (SSL) RSVP

Chapter 13: QOS Overview

QOS Documentation Structure

Determining Which Discussion ls for You

AdditionaI Information on QOS

About Quality of Service

lntroduction to QOS

Quality of Service Defined

Windows 2000 QuaIity of Service Defined

What QOS Solves

How Windows 2000 QOS Works

Windows 98 QOS Notes

QOS Header FiIes

QOS Components

Application-Driven QOS Components

Network-Driven QOS Components

PoIicy-Driven QOS Components

RSVP and QOS

Chapter 14: Q0S Programming,

Basic QOS Operations

QOS-Enabling Your AppIication

Opening a QOS-Enabled Socket

Invoking the RSVP SP

Providing the RSVP SP with QOS-specific Parameters

Receiving QOS-Enabled Data

Sending QOS-EnabIed Data

CIosing the QOS Connection

QOS TempIates

Enumerating AvaiIable QOS TempIates

AppIying a QOS Template

lnstaIIing a QOS TempIate

Removing a QOS TempIate

BuiIt-in QOS TempIates

RSVP SP Error Codes

Error Codes

Error Values

Service Types

Primary Service Types

BEST EFFORT

CONTROLLED LOAD

GUARANTEED

QUALITATlVE

Secondary Service Types

SERVICETYPE NOTRAFFlC

SERVICETYPE--GENERALINFORMATlON

SERVlCETYPE NOCHANGE

SERVlCE--NO--TRAFFIC--CONTROL

SERVlCE NO QOS SIGNALING

Using Service Types

DirectionaI lmpIications of Service Types

Examples of Setting the Service Type

Using the ProviderSpecific Buffer

Structure of the ProviderSpecific Buffer

Use of the ProviderSpecific Buffer as a Receiver

Use of the ProviderSpecific Buffer as a Sender

Understanding Traffic Control

How the RSVP SP lnvokes TC

Using SIO--CHK--QOS

Disabling Traffic ControI

QOS Events

Listening for FD--QOS Events

Using WSAEventSelect or WSAAsyncSeIect

Using OverIapped WSAIoctl(SIO--GET--QOS)

QOS Event Codes

RSVP SP and RSVP

Basic RSVP Operations

lnvoking RSVP

Using the RSVP--RESERVE--INFO Object

Confirming RSVP Reservations

DisabIing RSVP SignaIing

RSVP Reservation Styles

Base RSVP Reservation StyIes

DefauIt RSVP FiIter StyIe Settings

Overriding Default RSVP FiIter Style Settings

Mapping RSVP SP Parameters to RSVP

RSVP PATH and RESV Messages

Tspec, FIowSpec, and Adspec

Mapping QOS CaIl Sequences to RSVP

Sending AppIications

Receiving AppIications

Receiver Reservation Semantics

Using WSAConnect to Join Unicast RSVP Sessions

Using WSAJoinLeaf to Join Multicast RSVP Sessions

Use of Sendto and WSASendTo by Multicast Senders

Using WSAIoctl(SlO--SET--QOS) During RSVP Sessions

Chapter 15: Q0S API Reference

QOS Functions

QOS Structures

QOS Objects

Chapter 16: Traffic Control API Reference

Traffic ControI Functions

Entry Points Exposed by Clients of the Traffic Control Interface

Traffic ControI Structures

Traffic Control Objects

Chapter 17: Local PoIicy Module APl Reference

LPM Functions

LPM Structures

Fart 3

Index: NetWorking Services Programming Elements - AIphab6ical Listing