428 lines
11 KiB
C
428 lines
11 KiB
C
/*++
|
|
|
|
Copyright (c) 1990 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
tdi.h
|
|
|
|
Abstract:
|
|
|
|
This module defines all the constructs that are used when referencing
|
|
the TDI (Transport Driver Interface) driver in NT.
|
|
|
|
Author:
|
|
|
|
Larry Osterman (LarryO) 1-Jun-1990
|
|
|
|
Revision History:
|
|
|
|
1-Jun-1990 LarryO
|
|
|
|
Created
|
|
|
|
--*/
|
|
#ifndef _BOWTDI_
|
|
#define _BOWTDI_
|
|
|
|
|
|
struct _TRANSPORT;
|
|
|
|
struct _TRANSPORT_NAME;
|
|
|
|
struct _BOWSER_TIMER;
|
|
|
|
typedef enum {
|
|
None,
|
|
PotentialBackup,
|
|
Backup,
|
|
Master
|
|
} BROWSERROLE, *PBROWSERROLES;
|
|
|
|
typedef enum {
|
|
Idle,
|
|
ElectionInProgress,
|
|
RunningElection,
|
|
DeafToElections // Set if no become master IRPs outstanding.
|
|
} ELECTIONROLE, *PELECTIONROLE;
|
|
|
|
struct _PAGED_TRANSPORT;
|
|
struct _PAGED_TRANSPORT_NAME;
|
|
|
|
|
|
typedef struct _TRANSPORT {
|
|
CSHORT Signature; // Structure signature.
|
|
CSHORT Size; // Structure size in bytes.
|
|
ULONG ReferenceCount; // Reference count for structure.
|
|
|
|
struct _PAGED_TRANSPORT *PagedTransport;
|
|
|
|
struct _TRANSPORT_NAME *ComputerName; // Computer name.
|
|
struct _TRANSPORT_NAME *PrimaryDomain;// Primary domain.
|
|
struct _TRANSPORT_NAME *AltPrimaryDomain;// Primary domain.
|
|
struct _TRANSPORT_NAME *MasterBrowser;// Master browser name.
|
|
struct _TRANSPORT_NAME *BrowserElection;// Master browser name.
|
|
|
|
PDOMAIN_INFO DomainInfo; // Domain being emulated.
|
|
|
|
ULONG DatagramSize; // Size of largest DG in bytes.
|
|
|
|
//
|
|
// The token is used to match incoming getbrowserserverlist responses with
|
|
// the request that they are associated with.
|
|
//
|
|
// It is protected by the backup list spin lock, and is incremented every
|
|
// time we send a GetBackupList request.
|
|
//
|
|
|
|
ULONG BrowserServerListToken; // Token for GetBrowserList request.
|
|
|
|
PFILE_OBJECT IpxSocketFileObject;
|
|
PDEVICE_OBJECT IpxSocketDeviceObject;
|
|
|
|
PBACKUP_LIST_RESPONSE_1 BowserBackupList;
|
|
|
|
//
|
|
// Role of workstation in election.
|
|
//
|
|
|
|
ELECTIONROLE ElectionState;
|
|
|
|
ERESOURCE AnnounceTableLock; // Lock for announce table.
|
|
ERESOURCE Lock; // Lock protecting fields below.
|
|
|
|
BOWSER_TIMER ElectionTimer;
|
|
|
|
BOWSER_TIMER FindMasterTimer;
|
|
|
|
//
|
|
// List of browser servers active
|
|
//
|
|
|
|
ERESOURCE BrowserServerListResource;// Resource protecting BrowserServerList.
|
|
|
|
KEVENT GetBackupListComplete;
|
|
|
|
IRP_QUEUE BecomeBackupQueue;
|
|
|
|
IRP_QUEUE BecomeMasterQueue;
|
|
|
|
IRP_QUEUE FindMasterQueue;
|
|
|
|
IRP_QUEUE WaitForMasterAnnounceQueue;
|
|
|
|
IRP_QUEUE ChangeRoleQueue;
|
|
|
|
IRP_QUEUE WaitForNewMasterNameQueue;
|
|
|
|
} TRANSPORT, *PTRANSPORT;
|
|
|
|
typedef struct _PAGED_TRANSPORT {
|
|
CSHORT Signature; // Structure signature.
|
|
CSHORT Size; // Structure size in bytes.
|
|
PTRANSPORT NonPagedTransport;
|
|
|
|
LIST_ENTRY GlobalNext; // Pointer to next transport.
|
|
LIST_ENTRY NameChain; // List of names bound to this xport.
|
|
|
|
UNICODE_STRING TransportName; // Name of transport
|
|
|
|
ULONG NumberOfBrowserServers; // Number of browser servers in table.
|
|
ULONG NumberOfServersInTable; // Number of servers in browser svc.
|
|
RTL_GENERIC_TABLE AnnouncementTable; // Announcement table for xport
|
|
RTL_GENERIC_TABLE DomainTable; // Domain table for xport
|
|
LIST_ENTRY BackupBrowserList; // List of active backup browsers.
|
|
ULONG NumberOfBackupServerListEntries;
|
|
HANDLE IpxSocketHandle;
|
|
|
|
//
|
|
// WinBALL compatible browser fields.
|
|
//
|
|
|
|
BROWSERROLE Role; // Role of browser in domain.
|
|
ULONG ServiceStatus; // Status of browser service.
|
|
|
|
ULONG ElectionCount;
|
|
ULONG ElectionsSent; // Number of election requests sent.
|
|
ULONG NextElection;
|
|
ULONG Uptime;
|
|
ULONG TimeLastLost;
|
|
ULONG ElectionCriteria;
|
|
ULONG TimeMaster; // The time we became the master.
|
|
ULONG LastElectionSeen; // The last time we saw an election.
|
|
ULONG OtherMasterTime; // Next time we can complain about another master browser
|
|
|
|
UNICODE_STRING MasterName;
|
|
STRING MasterBrowserAddress;
|
|
|
|
PWCHAR *BrowserServerListBuffer; // Buffer containing browser server names
|
|
|
|
ULONG BrowserServerListLength; // Number of browser servers in list.
|
|
|
|
ULONG IpSubnetNumber; //
|
|
|
|
USHORT Flags; // Flags for transport.
|
|
#define ELECT_LOST_LAST_ELECTION 0x0001 // True if we lost the last election.
|
|
#define DIRECT_HOST_IPX 0x8000 // True if Xport is a direct host IPX
|
|
|
|
BOOLEAN Wannish; // True if transport is wannish.
|
|
BOOLEAN PointToPoint; // True if transport is a gateway (RAS).
|
|
BOOLEAN IsPrimaryDomainController; // True if transport has the Domain[1B] name registered
|
|
BOOLEAN DisabledTransport; // True if transport is disabled
|
|
BOOLEAN DeletedTransport; // True if transport has been deleted
|
|
|
|
} PAGED_TRANSPORT, *PPAGED_TRANSPORT;
|
|
|
|
|
|
|
|
|
|
typedef struct _TRANSPORT_NAME {
|
|
USHORT Signature; // Structure signature.
|
|
USHORT Size; // Structure size in bytes.
|
|
CHAR NameType;
|
|
BOOLEAN ProcessHostAnnouncements; // TRUE if processing announcements.
|
|
LONG ReferenceCount; // Reference count for T.N.
|
|
struct _PAGED_TRANSPORT_NAME *PagedTransportName;
|
|
PTRANSPORT Transport;
|
|
PFILE_OBJECT FileObject; // File object for transport device
|
|
PDEVICE_OBJECT DeviceObject; // Device object for transport
|
|
ANSI_STRING TransportAddress; // Transport address for user.
|
|
} TRANSPORT_NAME, *PTRANSPORT_NAME;
|
|
|
|
typedef struct _PAGED_TRANSPORT_NAME {
|
|
CSHORT Signature; // Structure signature.
|
|
CSHORT Size; // Structure size in bytes.
|
|
PTRANSPORT_NAME NonPagedTransportName;
|
|
PBOWSER_NAME Name;
|
|
LIST_ENTRY TransportNext; // Pointer to next name on transport.
|
|
LIST_ENTRY NameNext; // Pointer to next name on bowser name.
|
|
HANDLE Handle; // Handle to transport endpoint
|
|
} PAGED_TRANSPORT_NAME, *PPAGED_TRANSPORT_NAME;
|
|
|
|
#define LOCK_TRANSPORT(Transport) \
|
|
ExAcquireResourceExclusiveLite(&(Transport)->Lock, TRUE);
|
|
|
|
#define LOCK_TRANSPORT_SHARED(Transport) \
|
|
ExAcquireResourceSharedLite(&(Transport)->Lock, TRUE);
|
|
|
|
#define UNLOCK_TRANSPORT(Transport) \
|
|
ExReleaseResourceLite(&(Transport)->Lock);
|
|
|
|
|
|
#define INITIALIZE_ANNOUNCE_DATABASE(Transport) \
|
|
ExInitializeResourceLite(&Transport->AnnounceTableLock);
|
|
|
|
#define UNINITIALIZE_ANNOUNCE_DATABASE(Transport) \
|
|
ExDeleteResourceLite(&Transport->AnnounceTableLock);
|
|
|
|
|
|
#define LOCK_ANNOUNCE_DATABASE_SHARED(Transport) \
|
|
ExAcquireResourceSharedLite(&Transport->AnnounceTableLock,\
|
|
TRUE \
|
|
);
|
|
|
|
#define LOCK_ANNOUNCE_DATABASE(Transport) \
|
|
ExAcquireResourceExclusiveLite(&Transport->AnnounceTableLock,\
|
|
TRUE \
|
|
);
|
|
|
|
#define UNLOCK_ANNOUNCE_DATABASE(Transport) \
|
|
ExReleaseResourceLite(&Transport->AnnounceTableLock);
|
|
|
|
|
|
//
|
|
// The first parameter to the BowserEnumerateTransports routine.
|
|
//
|
|
|
|
typedef
|
|
NTSTATUS
|
|
(*PTRANSPORT_ENUM_ROUTINE) (
|
|
IN PTRANSPORT Transport,
|
|
IN OUT PVOID Context
|
|
);
|
|
|
|
typedef
|
|
NTSTATUS
|
|
(*PTRANSPORT_NAME_ENUM_ROUTINE) (
|
|
IN PTRANSPORT_NAME Transport,
|
|
IN OUT PVOID Context
|
|
);
|
|
|
|
|
|
//
|
|
// TDI Interface routines
|
|
//
|
|
|
|
NTSTATUS
|
|
BowserTdiAllocateTransport (
|
|
PUNICODE_STRING TransportName,
|
|
PUNICODE_STRING EmulatedDomainName,
|
|
PUNICODE_STRING EmulatedComputerName
|
|
);
|
|
|
|
PTRANSPORT_NAME
|
|
BowserFindTransportName(
|
|
IN PTRANSPORT Transport,
|
|
IN PBOWSER_NAME Name
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserCreateTransportName (
|
|
IN PTRANSPORT Transport,
|
|
IN PBOWSER_NAME Name
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserFreeTransportByName (
|
|
IN PUNICODE_STRING TransportName,
|
|
IN PUNICODE_STRING EmulatedDomainName
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserUnbindFromAllTransports(
|
|
VOID
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserDeleteTransportNameByName(
|
|
IN PTRANSPORT Transport,
|
|
IN PUNICODE_STRING Name,
|
|
IN DGRECEIVER_NAME_TYPE NameType
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserEnumerateTransports (
|
|
OUT PVOID OutputBuffer,
|
|
OUT ULONG OutputBufferLength,
|
|
IN OUT PULONG EntriesRead,
|
|
IN OUT PULONG TotalEntries,
|
|
IN OUT PULONG TotalBytesNeeded,
|
|
IN ULONG_PTR OutputBufferDisplacement);
|
|
|
|
PTRANSPORT
|
|
BowserFindTransport (
|
|
IN PUNICODE_STRING TransportName,
|
|
IN PUNICODE_STRING EmulatedDomainName OPTIONAL
|
|
);
|
|
|
|
VOID
|
|
BowserReferenceTransport (
|
|
IN PTRANSPORT Transport
|
|
);
|
|
|
|
VOID
|
|
BowserDereferenceTransport (
|
|
IN PTRANSPORT Transport
|
|
);
|
|
|
|
|
|
VOID
|
|
BowserReferenceTransportName(
|
|
IN PTRANSPORT_NAME TransportName
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserDereferenceTransportName(
|
|
IN PTRANSPORT_NAME TransportName
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserSendRequestAnnouncement(
|
|
IN PUNICODE_STRING DestinationName,
|
|
IN DGRECEIVER_NAME_TYPE NameType,
|
|
IN PTRANSPORT Transport
|
|
);
|
|
|
|
VOID
|
|
BowserpInitializeTdi (
|
|
VOID
|
|
);
|
|
|
|
VOID
|
|
BowserpUninitializeTdi (
|
|
VOID
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserBuildTransportAddress (
|
|
OUT PANSI_STRING RemoteAddress,
|
|
IN PUNICODE_STRING Name,
|
|
IN DGRECEIVER_NAME_TYPE NameType,
|
|
IN PTRANSPORT Transport
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserFreeTransportName(
|
|
IN PTRANSPORT_NAME TransportName
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserForEachTransportInDomain (
|
|
IN PDOMAIN_INFO DomainInfo,
|
|
IN PTRANSPORT_ENUM_ROUTINE Routine,
|
|
IN OUT PVOID Context
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserForEachTransport (
|
|
IN PTRANSPORT_ENUM_ROUTINE Routine,
|
|
IN OUT PVOID Context
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserForEachTransportName (
|
|
IN PTRANSPORT Transport,
|
|
IN PTRANSPORT_NAME_ENUM_ROUTINE Routine,
|
|
IN OUT PVOID Context
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserSendSecondClassMailslot (
|
|
IN PTRANSPORT Transport,
|
|
IN PVOID RecipientAddress,
|
|
IN DGRECEIVER_NAME_TYPE NameType,
|
|
IN PVOID Message,
|
|
IN ULONG MessageLength,
|
|
IN BOOLEAN WaitForCompletion,
|
|
IN PCHAR mailslotNameData,
|
|
IN PSTRING DestinationAddress OPTIONAL
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserUpdateProviderInformation(
|
|
IN OUT PPAGED_TRANSPORT PagedTransport
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserSetDomainName(
|
|
PDOMAIN_INFO DomainInfo,
|
|
PUNICODE_STRING DomainName
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserAddDefaultNames(
|
|
IN PTRANSPORT Transport,
|
|
IN PVOID Context
|
|
);
|
|
|
|
NTSTATUS
|
|
BowserDeleteDefaultDomainNames(
|
|
IN PTRANSPORT Transport,
|
|
IN PVOID Context
|
|
);
|
|
|
|
ULONG
|
|
BowserTransportFlags(
|
|
IN PPAGED_TRANSPORT PagedTransport
|
|
);
|
|
|
|
extern
|
|
LIST_ENTRY
|
|
BowserTransportHead;
|
|
|
|
extern
|
|
ERESOURCE
|
|
BowserTransportDatabaseResource;
|
|
|
|
#endif // _BOWTDI_
|