2 * COPYRIGHT: See COPYING in the top level directory
3 * PROJECT: ReactOS TCP/IP protocol driver
5 * PURPOSE: Local Area Network media routines
6 * PROGRAMMERS: Casper S. Hornstrup (chorns@users.sourceforge.net)
8 * CSH 01/08-2000 Created
13 UINT TransferDataCalled
= 0;
14 UINT TransferDataCompleteCalled
= 0;
15 UINT LanReceiveWorkerCalled
= 0;
16 BOOLEAN LanReceiveWorkerBusy
= FALSE
;
18 #define CCS_ROOT L"\\Registry\\Machine\\SYSTEM\\CurrentControlSet"
19 #define TCPIP_GUID L"{4D36E972-E325-11CE-BFC1-08002BE10318}"
21 #define NGFP(_Packet) \
24 ULONG _ContigSize, _TotalSize; \
25 PNDIS_BUFFER _NdisBuffer; \
27 TI_DbgPrint(MID_TRACE,("Checking Packet %x\n", _Packet)); \
28 NdisGetFirstBufferFromPacket(_Packet, \
33 TI_DbgPrint(MID_TRACE,("NdisBuffer: %x\n", _NdisBuffer)); \
34 TI_DbgPrint(MID_TRACE,("Header : %x\n", _Header)); \
35 TI_DbgPrint(MID_TRACE,("ContigSize: %x\n", _ContigSize)); \
36 TI_DbgPrint(MID_TRACE,("TotalSize : %x\n", _TotalSize)); \
39 typedef struct _LAN_WQ_ITEM
{
43 UINT BytesTransferred
;
44 } LAN_WQ_ITEM
, *PLAN_WQ_ITEM
;
46 NDIS_HANDLE NdisProtocolHandle
= (NDIS_HANDLE
)NULL
;
47 BOOLEAN ProtocolRegistered
= FALSE
;
48 LIST_ENTRY AdapterListHead
;
49 KSPIN_LOCK AdapterListLock
;
53 NDIS_REQUEST_TYPE Type
,
58 * FUNCTION: Send a request to NDIS
60 * Adapter = Pointer to a LAN_ADAPTER structure
61 * Type = Type of request (Set or Query)
62 * OID = Value to be set/queried for
63 * Buffer = Pointer to a buffer to use
64 * Length = Number of bytes in Buffer
70 NDIS_STATUS NdisStatus
;
72 Request
.RequestType
= Type
;
73 if (Type
== NdisRequestSetInformation
) {
74 Request
.DATA
.SET_INFORMATION
.Oid
= OID
;
75 Request
.DATA
.SET_INFORMATION
.InformationBuffer
= Buffer
;
76 Request
.DATA
.SET_INFORMATION
.InformationBufferLength
= Length
;
78 Request
.DATA
.QUERY_INFORMATION
.Oid
= OID
;
79 Request
.DATA
.QUERY_INFORMATION
.InformationBuffer
= Buffer
;
80 Request
.DATA
.QUERY_INFORMATION
.InformationBufferLength
= Length
;
83 if (Adapter
->State
!= LAN_STATE_RESETTING
) {
84 NdisRequest(&NdisStatus
, Adapter
->NdisHandle
, &Request
);
86 NdisStatus
= NDIS_STATUS_NOT_ACCEPTED
;
89 /* Wait for NDIS to complete the request */
90 if (NdisStatus
== NDIS_STATUS_PENDING
) {
91 KeWaitForSingleObject(&Adapter
->Event
,
96 NdisStatus
= Adapter
->NdisStatus
;
104 PLAN_ADAPTER Adapter
)
106 * FUNCTION: Frees memory for a LAN_ADAPTER structure
108 * Adapter = Pointer to LAN_ADAPTER structure to free
111 ExFreePoolWithTag(Adapter
, LAN_ADAPTER_TAG
);
115 NTSTATUS TcpipLanGetDwordOid
116 ( PIP_INTERFACE Interface
,
119 /* Get maximum frame size */
120 if( Interface
->Context
) {
121 return NDISCall((PLAN_ADAPTER
)Interface
->Context
,
122 NdisRequestQueryInformation
,
126 } else switch( Oid
) { /* Loopback Case */
127 case OID_GEN_HARDWARE_STATUS
:
128 *Result
= NdisHardwareStatusReady
;
129 return STATUS_SUCCESS
;
132 return STATUS_INVALID_PARAMETER
;
137 VOID NTAPI
ProtocolOpenAdapterComplete(
138 NDIS_HANDLE BindingContext
,
140 NDIS_STATUS OpenErrorStatus
)
142 * FUNCTION: Called by NDIS to complete opening of an adapter
144 * BindingContext = Pointer to a device context (LAN_ADAPTER)
145 * Status = Status of the operation
146 * OpenErrorStatus = Additional status information
149 PLAN_ADAPTER Adapter
= (PLAN_ADAPTER
)BindingContext
;
151 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
153 Adapter
->NdisStatus
= Status
;
155 KeSetEvent(&Adapter
->Event
, 0, FALSE
);
159 VOID NTAPI
ProtocolCloseAdapterComplete(
160 NDIS_HANDLE BindingContext
,
163 * FUNCTION: Called by NDIS to complete closing an adapter
165 * BindingContext = Pointer to a device context (LAN_ADAPTER)
166 * Status = Status of the operation
169 PLAN_ADAPTER Adapter
= (PLAN_ADAPTER
)BindingContext
;
171 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
173 Adapter
->NdisStatus
= Status
;
175 KeSetEvent(&Adapter
->Event
, 0, FALSE
);
179 VOID NTAPI
ProtocolResetComplete(
180 NDIS_HANDLE BindingContext
,
183 * FUNCTION: Called by NDIS to complete resetting an adapter
185 * BindingContext = Pointer to a device context (LAN_ADAPTER)
186 * Status = Status of the operation
189 PLAN_ADAPTER Adapter
= (PLAN_ADAPTER
)BindingContext
;
191 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
193 Adapter
->NdisStatus
= Status
;
195 KeSetEvent(&Adapter
->Event
, 0, FALSE
);
199 VOID NTAPI
ProtocolRequestComplete(
200 NDIS_HANDLE BindingContext
,
201 PNDIS_REQUEST NdisRequest
,
204 * FUNCTION: Called by NDIS to complete a request
206 * BindingContext = Pointer to a device context (LAN_ADAPTER)
207 * NdisRequest = Pointer to an object describing the request
208 * Status = Status of the operation
211 PLAN_ADAPTER Adapter
= (PLAN_ADAPTER
)BindingContext
;
213 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
215 /* Save status of request and signal an event */
216 Adapter
->NdisStatus
= Status
;
218 KeSetEvent(&Adapter
->Event
, 0, FALSE
);
222 VOID NTAPI
ProtocolSendComplete(
223 NDIS_HANDLE BindingContext
,
227 * FUNCTION: Called by NDIS to complete sending process
229 * BindingContext = Pointer to a device context (LAN_ADAPTER)
230 * Packet = Pointer to a packet descriptor
231 * Status = Status of the operation
234 FreeNdisPacket(Packet
);
237 VOID
LanReceiveWorker( PVOID Context
) {
239 PLAN_WQ_ITEM WorkItem
= (PLAN_WQ_ITEM
)Context
;
241 PLAN_ADAPTER Adapter
;
242 UINT BytesTransferred
;
243 PNDIS_BUFFER NdisBuffer
;
246 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
248 Packet
= WorkItem
->Packet
;
249 Adapter
= WorkItem
->Adapter
;
250 BytesTransferred
= WorkItem
->BytesTransferred
;
252 ExFreePoolWithTag(WorkItem
, WQ_CONTEXT_TAG
);
254 IPInitializePacket(&IPPacket
, 0);
256 IPPacket
.NdisPacket
= Packet
;
258 NdisGetFirstBufferFromPacket(Packet
,
261 &IPPacket
.ContigSize
,
262 &IPPacket
.TotalSize
);
264 IPPacket
.ContigSize
= IPPacket
.TotalSize
= BytesTransferred
;
265 /* Determine which upper layer protocol that should receive
266 this packet and pass it to the correct receive handler */
268 TI_DbgPrint(MID_TRACE
,
269 ("ContigSize: %d, TotalSize: %d, BytesTransferred: %d\n",
270 IPPacket
.ContigSize
, IPPacket
.TotalSize
,
273 PacketType
= PC(IPPacket
.NdisPacket
)->PacketType
;
274 IPPacket
.Position
= 0;
278 ("Ether Type = %x ContigSize = %d Total = %d\n",
279 PacketType
, IPPacket
.ContigSize
, IPPacket
.TotalSize
));
281 switch (PacketType
) {
284 TI_DbgPrint(MID_TRACE
,("Received IP Packet\n"));
285 IPReceive(Adapter
->Context
, &IPPacket
);
288 TI_DbgPrint(MID_TRACE
,("Received ARP Packet\n"));
289 ARPReceive(Adapter
->Context
, &IPPacket
);
291 IPPacket
.Free(&IPPacket
);
295 FreeNdisPacket( Packet
);
298 VOID
LanSubmitReceiveWork(
299 NDIS_HANDLE BindingContext
,
302 UINT BytesTransferred
) {
303 PLAN_WQ_ITEM WQItem
= ExAllocatePoolWithTag(NonPagedPool
, sizeof(LAN_WQ_ITEM
),
305 PLAN_ADAPTER Adapter
= (PLAN_ADAPTER
)BindingContext
;
307 TI_DbgPrint(DEBUG_DATALINK
,("called\n"));
311 WQItem
->Packet
= Packet
;
312 WQItem
->Adapter
= Adapter
;
313 WQItem
->BytesTransferred
= BytesTransferred
;
315 if (!ChewCreate( LanReceiveWorker
, WQItem
))
316 ExFreePoolWithTag(WQItem
, WQ_CONTEXT_TAG
);
319 VOID NTAPI
ProtocolTransferDataComplete(
320 NDIS_HANDLE BindingContext
,
323 UINT BytesTransferred
)
325 * FUNCTION: Called by NDIS to complete reception of data
327 * BindingContext = Pointer to a device context (LAN_ADAPTER)
328 * Packet = Pointer to a packet descriptor
329 * Status = Status of the operation
330 * BytesTransferred = Number of bytes transferred
332 * If the packet was successfully received, determine the protocol
333 * type and pass it to the correct receive handler
336 ASSERT(KeGetCurrentIrql() == DISPATCH_LEVEL
);
338 TI_DbgPrint(DEBUG_DATALINK
,("called\n"));
340 TransferDataCompleteCalled
++;
341 ASSERT(TransferDataCompleteCalled
<= TransferDataCalled
);
343 if( Status
!= NDIS_STATUS_SUCCESS
) return;
345 LanSubmitReceiveWork( BindingContext
, Packet
, Status
, BytesTransferred
);
348 NDIS_STATUS NTAPI
ProtocolReceive(
349 NDIS_HANDLE BindingContext
,
350 NDIS_HANDLE MacReceiveContext
,
352 UINT HeaderBufferSize
,
353 PVOID LookaheadBuffer
,
354 UINT LookaheadBufferSize
,
357 * FUNCTION: Called by NDIS when a packet has been received on the physical link
359 * BindingContext = Pointer to a device context (LAN_ADAPTER)
360 * MacReceiveContext = Handle used by underlying NIC driver
361 * HeaderBuffer = Pointer to a buffer containing the packet header
362 * HeaderBufferSize = Number of bytes in HeaderBuffer
363 * LookaheadBuffer = Pointer to a buffer containing buffered packet data
364 * LookaheadBufferSize = Size of LookaheadBuffer. May be less than asked for
365 * PacketSize = Overall size of the packet (not including header)
367 * Status of operation
371 UINT PacketType
, BytesTransferred
;
375 NDIS_STATUS NdisStatus
;
376 PNDIS_PACKET NdisPacket
;
377 PLAN_ADAPTER Adapter
= (PLAN_ADAPTER
)BindingContext
;
378 PETH_HEADER EHeader
= (PETH_HEADER
)HeaderBuffer
;
380 TI_DbgPrint(DEBUG_DATALINK
, ("Called. (packetsize %d)\n",PacketSize
));
382 if (Adapter
->State
!= LAN_STATE_STARTED
) {
383 TI_DbgPrint(DEBUG_DATALINK
, ("Adapter is stopped.\n"));
384 return NDIS_STATUS_NOT_ACCEPTED
;
387 if (HeaderBufferSize
< Adapter
->HeaderSize
) {
388 TI_DbgPrint(DEBUG_DATALINK
, ("Runt frame received.\n"));
389 return NDIS_STATUS_NOT_ACCEPTED
;
392 if (Adapter
->Media
== NdisMedium802_3
) {
393 /* Ethernet and IEEE 802.3 frames can be destinguished by
394 looking at the IEEE 802.3 length field. This field is
395 less than or equal to 1500 for a valid IEEE 802.3 frame
396 and larger than 1500 is it's a valid EtherType value.
397 See RFC 1122, section 2.3.3 for more information */
398 /* FIXME: Test for Ethernet and IEEE 802.3 frame */
399 if (((EType
= EHeader
->EType
) != ETYPE_IPv4
) && (EType
!= ETYPE_ARP
)) {
400 TI_DbgPrint(DEBUG_DATALINK
, ("Not IP or ARP frame. EtherType (0x%X).\n", EType
));
401 return NDIS_STATUS_NOT_ACCEPTED
;
403 /* We use EtherType constants to destinguish packet types */
406 TI_DbgPrint(MIN_TRACE
, ("Unsupported media.\n"));
407 /* FIXME: Support other medias */
408 return NDIS_STATUS_NOT_ACCEPTED
;
411 /* Get a transfer data packet */
413 TI_DbgPrint(DEBUG_DATALINK
, ("Adapter: %x (MTU %d)\n",
414 Adapter
, Adapter
->MTU
));
416 NdisStatus
= AllocatePacketWithBuffer( &NdisPacket
, NULL
,
418 if( NdisStatus
!= NDIS_STATUS_SUCCESS
) {
419 return NDIS_STATUS_NOT_ACCEPTED
;
422 PC(NdisPacket
)->PacketType
= PacketType
;
424 TI_DbgPrint(DEBUG_DATALINK
, ("pretransfer LookaheadBufferSize %d packsize %d\n",LookaheadBufferSize
,PacketSize
));
426 GetDataPtr( NdisPacket
, 0, &BufferData
, &temp
);
428 IPPacket
.NdisPacket
= NdisPacket
;
429 IPPacket
.Position
= 0;
431 TransferDataCalled
++;
433 if (LookaheadBufferSize
== PacketSize
)
435 /* Optimized code path for packets that are fully contained in
436 * the lookahead buffer. */
437 NdisCopyLookaheadData(BufferData
,
440 Adapter
->MacOptions
);
444 NdisTransferData(&NdisStatus
, Adapter
->NdisHandle
,
445 MacReceiveContext
, 0, PacketSize
,
446 NdisPacket
, &BytesTransferred
);
448 TI_DbgPrint(DEBUG_DATALINK
, ("Calling complete\n"));
450 if (NdisStatus
!= NDIS_STATUS_PENDING
)
451 ProtocolTransferDataComplete(BindingContext
,
456 TI_DbgPrint(DEBUG_DATALINK
, ("leaving\n"));
458 return NDIS_STATUS_SUCCESS
;
462 VOID NTAPI
ProtocolReceiveComplete(
463 NDIS_HANDLE BindingContext
)
465 * FUNCTION: Called by NDIS when we're done receiving data
467 * BindingContext = Pointer to a device context (LAN_ADAPTER)
470 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
474 VOID NTAPI
ProtocolStatus(
475 NDIS_HANDLE BindingContext
,
476 NDIS_STATUS GeneralStatus
,
478 UINT StatusBufferSize
)
480 * FUNCTION: Called by NDIS when the underlying driver has changed state
482 * BindingContext = Pointer to a device context (LAN_ADAPTER)
483 * GeneralStatus = A general status code
484 * StatusBuffer = Pointer to a buffer with medium-specific data
485 * StatusBufferSize = Number of bytes in StatusBuffer
488 PLAN_ADAPTER Adapter
= BindingContext
;
490 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
492 switch(GeneralStatus
)
494 case NDIS_STATUS_MEDIA_CONNECT
:
495 DbgPrint("NDIS_STATUS_MEDIA_CONNECT\n");
498 case NDIS_STATUS_MEDIA_DISCONNECT
:
499 DbgPrint("NDIS_STATUS_MEDIA_DISCONNECT\n");
502 case NDIS_STATUS_RESET_START
:
503 Adapter
->State
= LAN_STATE_RESETTING
;
506 case NDIS_STATUS_RESET_END
:
507 Adapter
->State
= LAN_STATE_STARTED
;
511 DbgPrint("Unhandled status: %x", GeneralStatus
);
518 NDIS_HANDLE NdisBindingContext
,
519 PNET_PNP_EVENT PnPEvent
)
521 switch(PnPEvent
->NetEvent
)
523 case NetEventSetPower
:
524 DbgPrint("Device transitioned to power state %ld\n", PnPEvent
->Buffer
);
525 return NDIS_STATUS_SUCCESS
;
527 case NetEventQueryPower
:
528 DbgPrint("Device wants to go into power state %ld\n", PnPEvent
->Buffer
);
529 return NDIS_STATUS_SUCCESS
;
531 case NetEventQueryRemoveDevice
:
532 DbgPrint("Device is about to be removed\n");
533 return NDIS_STATUS_SUCCESS
;
535 case NetEventCancelRemoveDevice
:
536 DbgPrint("Device removal cancelled\n");
537 return NDIS_STATUS_SUCCESS
;
540 DbgPrint("Unhandled event type: %ld\n", PnPEvent
->NetEvent
);
541 return NDIS_STATUS_SUCCESS
;
545 VOID NTAPI
ProtocolStatusComplete(
546 NDIS_HANDLE NdisBindingContext
)
548 * FUNCTION: Called by NDIS when a status-change has occurred
550 * BindingContext = Pointer to a device context (LAN_ADAPTER)
553 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
556 VOID NTAPI
ProtocolBindAdapter(
557 OUT PNDIS_STATUS Status
,
558 IN NDIS_HANDLE BindContext
,
559 IN PNDIS_STRING DeviceName
,
560 IN PVOID SystemSpecific1
,
561 IN PVOID SystemSpecific2
)
563 * FUNCTION: Called by NDIS during NdisRegisterProtocol to set up initial
564 * bindings, and periodically thereafer as new adapters come online
566 * Status: Return value to NDIS
567 * BindContext: Handle provided by NDIS to track pending binding operations
568 * DeviceName: Name of the miniport device to bind to
569 * SystemSpecific1: Pointer to a registry path with protocol-specific configuration information
570 * SystemSpecific2: Unused & must not be touched
573 /* XXX confirm that this is still true, or re-word the following comment */
574 /* we get to ignore BindContext because we will never pend an operation with NDIS */
575 TI_DbgPrint(DEBUG_DATALINK
, ("Called with registry path %wZ for %wZ\n", SystemSpecific1
, DeviceName
));
576 *Status
= LANRegisterAdapter(DeviceName
, SystemSpecific1
);
582 PNDIS_PACKET NdisPacket
,
587 * FUNCTION: Transmits a packet
589 * Context = Pointer to context information (LAN_ADAPTER)
590 * NdisPacket = Pointer to NDIS packet to send
591 * Offset = Offset in packet where data starts
592 * LinkAddress = Pointer to link address of destination (NULL = broadcast)
593 * Type = LAN protocol type (LAN_PROTO_*)
596 NDIS_STATUS NdisStatus
;
600 PLAN_ADAPTER Adapter
= (PLAN_ADAPTER
)Context
;
602 PNDIS_PACKET XmitPacket
;
604 TI_DbgPrint(DEBUG_DATALINK
,
605 ("Called( NdisPacket %x, Offset %d, Adapter %x )\n",
606 NdisPacket
, Offset
, Adapter
));
608 if (Adapter
->State
!= LAN_STATE_STARTED
) {
609 (*PC(NdisPacket
)->DLComplete
)(PC(NdisPacket
)->Context
, NdisPacket
, NDIS_STATUS_NOT_ACCEPTED
);
613 TI_DbgPrint(DEBUG_DATALINK
,
614 ("Adapter Address [%02x %02x %02x %02x %02x %02x]\n",
615 Adapter
->HWAddress
[0] & 0xff,
616 Adapter
->HWAddress
[1] & 0xff,
617 Adapter
->HWAddress
[2] & 0xff,
618 Adapter
->HWAddress
[3] & 0xff,
619 Adapter
->HWAddress
[4] & 0xff,
620 Adapter
->HWAddress
[5] & 0xff));
622 GetDataPtr( NdisPacket
, 0, &OldData
, &OldSize
);
624 NdisStatus
= AllocatePacketWithBuffer(&XmitPacket
, NULL
, OldSize
+ Adapter
->HeaderSize
);
625 if (NdisStatus
!= NDIS_STATUS_SUCCESS
) {
626 (*PC(NdisPacket
)->DLComplete
)(PC(NdisPacket
)->Context
, NdisPacket
, NDIS_STATUS_RESOURCES
);
630 GetDataPtr(XmitPacket
, 0, &Data
, &Size
);
632 RtlCopyMemory(Data
+ Adapter
->HeaderSize
, OldData
, OldSize
);
634 (*PC(NdisPacket
)->DLComplete
)(PC(NdisPacket
)->Context
, NdisPacket
, NDIS_STATUS_SUCCESS
);
636 switch (Adapter
->Media
) {
637 case NdisMedium802_3
:
638 EHeader
= (PETH_HEADER
)Data
;
641 /* Unicast address */
642 RtlCopyMemory(EHeader
->DstAddr
, LinkAddress
, IEEE_802_ADDR_LENGTH
);
644 /* Broadcast address */
645 RtlFillMemory(EHeader
->DstAddr
, IEEE_802_ADDR_LENGTH
, 0xFF);
648 RtlCopyMemory(EHeader
->SrcAddr
, Adapter
->HWAddress
, IEEE_802_ADDR_LENGTH
);
652 EHeader
->EType
= ETYPE_IPv4
;
655 EHeader
->EType
= ETYPE_ARP
;
658 EHeader
->EType
= ETYPE_IPv6
;
667 /* FIXME: Support other medias */
671 TI_DbgPrint( MID_TRACE
, ("LinkAddress: %x\n", LinkAddress
));
675 ("Link Address [%02x %02x %02x %02x %02x %02x]\n",
676 ((PCHAR
)LinkAddress
)[0] & 0xff,
677 ((PCHAR
)LinkAddress
)[1] & 0xff,
678 ((PCHAR
)LinkAddress
)[2] & 0xff,
679 ((PCHAR
)LinkAddress
)[3] & 0xff,
680 ((PCHAR
)LinkAddress
)[4] & 0xff,
681 ((PCHAR
)LinkAddress
)[5] & 0xff));
684 if (Adapter
->MTU
< Size
) {
685 /* This is NOT a pointer. MSDN explicitly says so. */
686 NDIS_PER_PACKET_INFO_FROM_PACKET(NdisPacket
,
687 TcpLargeSendPacketInfo
) = (PVOID
)((ULONG_PTR
)Adapter
->MTU
);
690 TcpipAcquireSpinLock( &Adapter
->Lock
, &OldIrql
);
691 TI_DbgPrint(MID_TRACE
, ("NdisSend\n"));
692 NdisSend(&NdisStatus
, Adapter
->NdisHandle
, XmitPacket
);
693 TI_DbgPrint(MID_TRACE
, ("NdisSend %s\n",
694 NdisStatus
== NDIS_STATUS_PENDING
?
695 "Pending" : "Complete"));
696 TcpipReleaseSpinLock( &Adapter
->Lock
, OldIrql
);
698 /* I had a talk with vizzini: these really ought to be here.
699 * we're supposed to see these completed by ndis *only* when
700 * status_pending is returned. Note that this is different from
701 * the situation with IRPs. */
702 if (NdisStatus
!= NDIS_STATUS_PENDING
)
703 ProtocolSendComplete((NDIS_HANDLE
)Context
, XmitPacket
, NdisStatus
);
707 OpenRegistryKey( PNDIS_STRING RegistryPath
, PHANDLE RegHandle
) {
708 OBJECT_ATTRIBUTES Attributes
;
711 InitializeObjectAttributes(&Attributes
, RegistryPath
, OBJ_CASE_INSENSITIVE
, 0, 0);
712 Status
= ZwOpenKey(RegHandle
, KEY_ALL_ACCESS
, &Attributes
);
716 static NTSTATUS
ReadStringFromRegistry( HANDLE RegHandle
,
717 PWCHAR RegistryValue
,
718 PUNICODE_STRING String
) {
719 UNICODE_STRING ValueName
;
720 UNICODE_STRING UnicodeString
;
724 PKEY_VALUE_PARTIAL_INFORMATION Information
= (PKEY_VALUE_PARTIAL_INFORMATION
)buf
;
726 RtlInitUnicodeString(&ValueName
, RegistryValue
);
728 ZwQueryValueKey(RegHandle
,
730 KeyValuePartialInformation
,
735 if (!NT_SUCCESS(Status
))
737 /* IP address is stored as a REG_MULTI_SZ - we only pay attention to the first one though */
738 TI_DbgPrint(MIN_TRACE
, ("Information DataLength: 0x%x\n", Information
->DataLength
));
740 UnicodeString
.Buffer
= (PWCHAR
)&Information
->Data
;
741 UnicodeString
.Length
= Information
->DataLength
- sizeof(WCHAR
);
742 UnicodeString
.MaximumLength
= Information
->DataLength
;
745 (PWCHAR
)ExAllocatePool( NonPagedPool
,
746 UnicodeString
.MaximumLength
+ sizeof(WCHAR
) );
748 if( !String
->Buffer
) return STATUS_NO_MEMORY
;
750 String
->MaximumLength
= UnicodeString
.MaximumLength
;
751 RtlCopyUnicodeString( String
, &UnicodeString
);
753 return STATUS_SUCCESS
;
757 * Utility to copy and append two unicode strings.
759 * IN OUT PUNICODE_STRING ResultFirst -> First string and result
760 * IN PUNICODE_STRING Second -> Second string to append
761 * IN BOOL Deallocate -> TRUE: Deallocate First string before
767 NTSTATUS NTAPI
AppendUnicodeString(PUNICODE_STRING ResultFirst
,
768 PUNICODE_STRING Second
,
769 BOOLEAN Deallocate
) {
771 UNICODE_STRING Ustr
= *ResultFirst
;
772 PWSTR new_string
= ExAllocatePool
774 (ResultFirst
->Length
+ Second
->Length
+ sizeof(WCHAR
)));
776 return STATUS_NO_MEMORY
;
778 memcpy( new_string
, ResultFirst
->Buffer
, ResultFirst
->Length
);
779 memcpy( new_string
+ ResultFirst
->Length
/ sizeof(WCHAR
),
780 Second
->Buffer
, Second
->Length
);
781 if( Deallocate
) RtlFreeUnicodeString(ResultFirst
);
782 ResultFirst
->Length
= Ustr
.Length
+ Second
->Length
;
783 ResultFirst
->MaximumLength
= ResultFirst
->Length
;
784 new_string
[ResultFirst
->Length
/ sizeof(WCHAR
)] = 0;
785 Status
= RtlCreateUnicodeString(ResultFirst
,new_string
) ?
786 STATUS_SUCCESS
: STATUS_NO_MEMORY
;
787 ExFreePool(new_string
);
791 static NTSTATUS
CheckForDeviceDesc( PUNICODE_STRING EnumKeyName
,
792 PUNICODE_STRING TargetKeyName
,
793 PUNICODE_STRING Name
,
794 PUNICODE_STRING DeviceDesc
) {
795 UNICODE_STRING RootDevice
= { 0, 0, NULL
}, LinkageKeyName
= { 0, 0, NULL
};
796 UNICODE_STRING DescKeyName
= { 0, 0, NULL
}, Linkage
= { 0, 0, NULL
};
797 UNICODE_STRING BackSlash
= { 0, 0, NULL
};
798 HANDLE DescKey
= NULL
, LinkageKey
= NULL
;
801 TI_DbgPrint(DEBUG_DATALINK
,("EnumKeyName %wZ\n", EnumKeyName
));
803 RtlInitUnicodeString(&BackSlash
, L
"\\");
804 RtlInitUnicodeString(&Linkage
, L
"\\Linkage");
806 RtlInitUnicodeString(&DescKeyName
, L
"");
807 AppendUnicodeString( &DescKeyName
, EnumKeyName
, FALSE
);
808 AppendUnicodeString( &DescKeyName
, &BackSlash
, TRUE
);
809 AppendUnicodeString( &DescKeyName
, TargetKeyName
, TRUE
);
811 RtlInitUnicodeString(&LinkageKeyName
, L
"");
812 AppendUnicodeString( &LinkageKeyName
, &DescKeyName
, FALSE
);
813 AppendUnicodeString( &LinkageKeyName
, &Linkage
, TRUE
);
815 Status
= OpenRegistryKey( &LinkageKeyName
, &LinkageKey
);
816 if( !NT_SUCCESS(Status
) ) goto cleanup
;
818 Status
= ReadStringFromRegistry( LinkageKey
, L
"RootDevice", &RootDevice
);
819 if( !NT_SUCCESS(Status
) ) goto cleanup
;
821 if( RtlCompareUnicodeString( &RootDevice
, Name
, TRUE
) == 0 ) {
822 Status
= OpenRegistryKey( &DescKeyName
, &DescKey
);
823 if( !NT_SUCCESS(Status
) ) goto cleanup
;
825 Status
= ReadStringFromRegistry( DescKey
, L
"DriverDesc", DeviceDesc
);
826 if( !NT_SUCCESS(Status
) ) goto cleanup
;
828 TI_DbgPrint(DEBUG_DATALINK
,("ADAPTER DESC: %wZ\n", DeviceDesc
));
829 } else Status
= STATUS_UNSUCCESSFUL
;
832 RtlFreeUnicodeString( &RootDevice
);
833 RtlFreeUnicodeString( &LinkageKeyName
);
834 RtlFreeUnicodeString( &DescKeyName
);
835 if( LinkageKey
) NtClose( LinkageKey
);
836 if( DescKey
) NtClose( DescKey
);
838 TI_DbgPrint(DEBUG_DATALINK
,("Returning %x\n", Status
));
843 static NTSTATUS
FindDeviceDescForAdapter( PUNICODE_STRING Name
,
844 PUNICODE_STRING DeviceDesc
) {
845 UNICODE_STRING EnumKeyName
, TargetKeyName
;
849 KEY_BASIC_INFORMATION
*Kbio
=
850 ExAllocatePool(NonPagedPool
, sizeof(KEY_BASIC_INFORMATION
));
851 ULONG KbioLength
= sizeof(KEY_BASIC_INFORMATION
), ResultLength
;
853 RtlInitUnicodeString( DeviceDesc
, NULL
);
855 if( !Kbio
) return STATUS_INSUFFICIENT_RESOURCES
;
858 (&EnumKeyName
, CCS_ROOT L
"\\Control\\Class\\" TCPIP_GUID
);
860 Status
= OpenRegistryKey( &EnumKeyName
, &EnumKey
);
862 if( !NT_SUCCESS(Status
) ) {
863 TI_DbgPrint(DEBUG_DATALINK
,("Couldn't open Enum key %wZ: %x\n",
864 &EnumKeyName
, Status
));
869 for( i
= 0; NT_SUCCESS(Status
); i
++ ) {
870 Status
= ZwEnumerateKey( EnumKey
, i
, KeyBasicInformation
,
871 Kbio
, KbioLength
, &ResultLength
);
873 if( Status
== STATUS_BUFFER_TOO_SMALL
|| Status
== STATUS_BUFFER_OVERFLOW
) {
875 KbioLength
= ResultLength
;
876 Kbio
= ExAllocatePool( NonPagedPool
, KbioLength
);
878 TI_DbgPrint(DEBUG_DATALINK
,("Failed to allocate memory\n"));
880 return STATUS_NO_MEMORY
;
883 Status
= ZwEnumerateKey( EnumKey
, i
, KeyBasicInformation
,
884 Kbio
, KbioLength
, &ResultLength
);
886 if( !NT_SUCCESS(Status
) ) {
887 TI_DbgPrint(DEBUG_DATALINK
,("Couldn't enum key child %d\n", i
));
894 if( NT_SUCCESS(Status
) ) {
895 TargetKeyName
.Length
= TargetKeyName
.MaximumLength
=
897 TargetKeyName
.Buffer
= Kbio
->Name
;
899 Status
= CheckForDeviceDesc
900 ( &EnumKeyName
, &TargetKeyName
, Name
, DeviceDesc
);
901 if( NT_SUCCESS(Status
) ) {
905 } else Status
= STATUS_SUCCESS
;
911 return STATUS_UNSUCCESSFUL
;
914 VOID
GetName( PUNICODE_STRING RegistryKey
,
915 PUNICODE_STRING OutName
) {
917 UNICODE_STRING PartialRegistryKey
;
919 PartialRegistryKey
.Buffer
=
920 RegistryKey
->Buffer
+ wcslen(CCS_ROOT L
"\\Services\\");
921 Ptr
= PartialRegistryKey
.Buffer
;
923 while( *Ptr
!= L
'\\' &&
924 ((PCHAR
)Ptr
) < ((PCHAR
)RegistryKey
->Buffer
) + RegistryKey
->Length
)
927 PartialRegistryKey
.Length
= PartialRegistryKey
.MaximumLength
=
928 (Ptr
- PartialRegistryKey
.Buffer
) * sizeof(WCHAR
);
930 RtlInitUnicodeString( OutName
, L
"" );
931 AppendUnicodeString( OutName
, &PartialRegistryKey
, FALSE
);
935 PLAN_ADAPTER Adapter
,
936 PNDIS_STRING RegistryPath
)
938 * FUNCTION: Binds a LAN adapter to IP layer
940 * Adapter = Pointer to LAN_ADAPTER structure
942 * We set the lookahead buffer size, set the packet filter and
943 * bind the adapter to IP layer
947 NDIS_STATUS NdisStatus
;
948 LLIP_BIND_INFO BindInfo
;
949 IP_ADDRESS DefaultMask
;
950 ULONG Lookahead
= LOOKAHEAD_SIZE
;
953 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
955 Adapter
->State
= LAN_STATE_OPENING
;
957 NdisStatus
= NDISCall(Adapter
,
958 NdisRequestSetInformation
,
959 OID_GEN_CURRENT_LOOKAHEAD
,
962 if (NdisStatus
!= NDIS_STATUS_SUCCESS
) {
963 TI_DbgPrint(DEBUG_DATALINK
, ("Could not set lookahead buffer size (0x%X).\n", NdisStatus
));
967 /* Bind the adapter to IP layer */
968 BindInfo
.Context
= Adapter
;
969 BindInfo
.HeaderSize
= Adapter
->HeaderSize
;
970 BindInfo
.MinFrameSize
= Adapter
->MinFrameSize
;
971 BindInfo
.MTU
= Adapter
->MTU
;
972 BindInfo
.Address
= (PUCHAR
)&Adapter
->HWAddress
;
973 BindInfo
.AddressLength
= Adapter
->HWAddressLength
;
974 BindInfo
.Transmit
= LANTransmit
;
976 IF
= IPCreateInterface(&BindInfo
);
979 TI_DbgPrint(MIN_TRACE
, ("Insufficient resources.\n"));
984 * Query per-adapter configuration from the registry
985 * In case anyone is curious: there *is* an Ndis configuration api
986 * for this sort of thing, but it doesn't really support things like
987 * REG_MULTI_SZ very well, and there is a note in the DDK that says that
988 * protocol drivers developed for win2k and above just use the native
989 * services (ZwOpenKey, etc).
992 GetName( RegistryPath
, &IF
->Name
);
994 Status
= FindDeviceDescForAdapter( &IF
->Name
, &IF
->Description
);
995 if (!NT_SUCCESS(Status
)) {
996 TI_DbgPrint(MIN_TRACE
, ("Failed to get device description.\n"));
997 IPDestroyInterface(IF
);
1001 TI_DbgPrint(DEBUG_DATALINK
,("Adapter Description: %wZ\n",
1004 AddrInitIPv4(&DefaultMask
, 0);
1006 IF
->Unicast
= DefaultMask
;
1007 IF
->Netmask
= DefaultMask
;
1009 IF
->Broadcast
.Type
= IP_ADDRESS_V4
;
1010 IF
->Broadcast
.Address
.IPv4Address
=
1011 IF
->Unicast
.Address
.IPv4Address
|
1012 ~IF
->Netmask
.Address
.IPv4Address
;
1014 TI_DbgPrint(DEBUG_DATALINK
,("BCAST(IF) %s\n", A2S(&IF
->Broadcast
)));
1016 /* Get maximum link speed */
1017 NdisStatus
= NDISCall(Adapter
,
1018 NdisRequestQueryInformation
,
1023 if( !NT_SUCCESS(NdisStatus
) )
1024 IF
->Speed
= IP_DEFAULT_LINK_SPEED
;
1026 /* Register interface with IP layer */
1027 IPRegisterInterface(IF
);
1029 /* Set packet filter so we can send and receive packets */
1030 NdisStatus
= NDISCall(Adapter
,
1031 NdisRequestSetInformation
,
1032 OID_GEN_CURRENT_PACKET_FILTER
,
1033 &Adapter
->PacketFilter
,
1036 if (NdisStatus
!= NDIS_STATUS_SUCCESS
) {
1037 TI_DbgPrint(DEBUG_DATALINK
, ("Could not set packet filter (0x%X).\n", NdisStatus
));
1038 IPUnregisterInterface(IF
);
1039 IPDestroyInterface(IF
);
1043 Adapter
->Context
= IF
;
1044 Adapter
->State
= LAN_STATE_STARTED
;
1050 PLAN_ADAPTER Adapter
)
1052 * FUNCTION: Unbinds a LAN adapter from IP layer
1054 * Adapter = Pointer to LAN_ADAPTER structure
1057 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
1059 if (Adapter
->State
== LAN_STATE_STARTED
) {
1060 PIP_INTERFACE IF
= Adapter
->Context
;
1062 IPUnregisterInterface(IF
);
1064 IPDestroyInterface(IF
);
1069 NDIS_STATUS
LANRegisterAdapter(
1070 PNDIS_STRING AdapterName
,
1071 PNDIS_STRING RegistryPath
)
1073 * FUNCTION: Registers protocol with an NDIS adapter
1075 * AdapterName = Pointer to string with name of adapter to register
1076 * Adapter = Address of pointer to a LAN_ADAPTER structure
1078 * Status of operation
1082 NDIS_STATUS NdisStatus
;
1083 NDIS_STATUS OpenStatus
;
1085 NDIS_MEDIUM MediaArray
[MAX_MEDIA
];
1089 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
1091 IF
= ExAllocatePoolWithTag(NonPagedPool
, sizeof(LAN_ADAPTER
), LAN_ADAPTER_TAG
);
1093 TI_DbgPrint(MIN_TRACE
, ("Insufficient resources.\n"));
1094 return NDIS_STATUS_RESOURCES
;
1097 RtlZeroMemory(IF
, sizeof(LAN_ADAPTER
));
1099 /* Put adapter in stopped state */
1100 IF
->State
= LAN_STATE_STOPPED
;
1102 /* Initialize protecting spin lock */
1103 KeInitializeSpinLock(&IF
->Lock
);
1105 KeInitializeEvent(&IF
->Event
, SynchronizationEvent
, FALSE
);
1107 /* Initialize array with media IDs we support */
1108 MediaArray
[MEDIA_ETH
] = NdisMedium802_3
;
1110 TI_DbgPrint(DEBUG_DATALINK
,("opening adapter %wZ\n", AdapterName
));
1111 /* Open the adapter. */
1112 NdisOpenAdapter(&NdisStatus
,
1124 /* Wait until the adapter is opened */
1125 if (NdisStatus
== NDIS_STATUS_PENDING
)
1126 KeWaitForSingleObject(&IF
->Event
, UserRequest
, KernelMode
, FALSE
, NULL
);
1127 else if (NdisStatus
!= NDIS_STATUS_SUCCESS
) {
1128 TI_DbgPrint(DEBUG_DATALINK
,("denying adapter %wZ\n", AdapterName
));
1129 ExFreePoolWithTag(IF
, LAN_ADAPTER_TAG
);
1133 IF
->Media
= MediaArray
[MediaIndex
];
1135 /* Fill LAN_ADAPTER structure with some adapter specific information */
1136 switch (IF
->Media
) {
1137 case NdisMedium802_3
:
1138 IF
->HWAddressLength
= IEEE_802_ADDR_LENGTH
;
1139 IF
->BCastMask
= BCAST_ETH_MASK
;
1140 IF
->BCastCheck
= BCAST_ETH_CHECK
;
1141 IF
->BCastOffset
= BCAST_ETH_OFFSET
;
1142 IF
->HeaderSize
= sizeof(ETH_HEADER
);
1143 IF
->MinFrameSize
= 60;
1144 AddressOID
= OID_802_3_CURRENT_ADDRESS
;
1146 NDIS_PACKET_TYPE_BROADCAST
|
1147 NDIS_PACKET_TYPE_DIRECTED
|
1148 NDIS_PACKET_TYPE_MULTICAST
;
1152 /* Unsupported media */
1153 TI_DbgPrint(MIN_TRACE
, ("Unsupported media.\n"));
1154 ExFreePoolWithTag(IF
, LAN_ADAPTER_TAG
);
1155 return NDIS_STATUS_NOT_SUPPORTED
;
1158 /* Get maximum frame size */
1159 NdisStatus
= NDISCall(IF
,
1160 NdisRequestQueryInformation
,
1161 OID_GEN_MAXIMUM_FRAME_SIZE
,
1164 if (NdisStatus
!= NDIS_STATUS_SUCCESS
) {
1165 TI_DbgPrint(DEBUG_DATALINK
,("denying adapter %wZ (NDISCall)\n", AdapterName
));
1166 ExFreePoolWithTag(IF
, LAN_ADAPTER_TAG
);
1170 /* Get maximum packet size */
1171 NdisStatus
= NDISCall(IF
,
1172 NdisRequestQueryInformation
,
1173 OID_GEN_MAXIMUM_TOTAL_SIZE
,
1176 if (NdisStatus
!= NDIS_STATUS_SUCCESS
) {
1177 TI_DbgPrint(MIN_TRACE
, ("Query for maximum packet size failed.\n"));
1178 ExFreePoolWithTag(IF
, LAN_ADAPTER_TAG
);
1182 /* Get maximum number of packets we can pass to NdisSend(Packets) at one time */
1183 NdisStatus
= NDISCall(IF
,
1184 NdisRequestQueryInformation
,
1185 OID_GEN_MAXIMUM_SEND_PACKETS
,
1186 &IF
->MaxSendPackets
,
1188 if (NdisStatus
!= NDIS_STATUS_SUCCESS
)
1189 /* Legacy NIC drivers may not support this query, if it fails we
1190 assume it can send at least one packet per call to NdisSend(Packets) */
1191 IF
->MaxSendPackets
= 1;
1193 /* Get current hardware address */
1194 NdisStatus
= NDISCall(IF
,
1195 NdisRequestQueryInformation
,
1198 IF
->HWAddressLength
);
1199 if (NdisStatus
!= NDIS_STATUS_SUCCESS
) {
1200 TI_DbgPrint(MIN_TRACE
, ("Query for current hardware address failed.\n"));
1201 ExFreePoolWithTag(IF
, LAN_ADAPTER_TAG
);
1205 /* Get maximum link speed */
1206 NdisStatus
= NDISCall(IF
,
1207 NdisRequestQueryInformation
,
1211 if (NdisStatus
!= NDIS_STATUS_SUCCESS
) {
1212 TI_DbgPrint(MIN_TRACE
, ("Query for maximum link speed failed.\n"));
1213 ExFreePoolWithTag(IF
, LAN_ADAPTER_TAG
);
1217 /* Convert returned link speed to bps (it is in 100bps increments) */
1218 IF
->Speed
= Speed
* 100L;
1220 /* Bind adapter to IP layer */
1221 if( !BindAdapter(IF
, RegistryPath
) ) {
1222 TI_DbgPrint(DEBUG_DATALINK
,("denying adapter %wZ (BindAdapter)\n", AdapterName
));
1223 ExFreePoolWithTag(IF
, LAN_ADAPTER_TAG
);
1224 return NDIS_STATUS_NOT_ACCEPTED
;
1227 /* Add adapter to the adapter list */
1228 ExInterlockedInsertTailList(&AdapterListHead
,
1232 TI_DbgPrint(DEBUG_DATALINK
, ("Leaving.\n"));
1234 return NDIS_STATUS_SUCCESS
;
1238 NDIS_STATUS
LANUnregisterAdapter(
1239 PLAN_ADAPTER Adapter
)
1241 * FUNCTION: Unregisters protocol with NDIS adapter
1243 * Adapter = Pointer to a LAN_ADAPTER structure
1245 * Status of operation
1249 NDIS_HANDLE NdisHandle
;
1250 NDIS_STATUS NdisStatus
= NDIS_STATUS_SUCCESS
;
1252 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
1254 /* Unlink the adapter from the list */
1255 RemoveEntryList(&Adapter
->ListEntry
);
1257 /* Unbind adapter from IP layer */
1258 UnbindAdapter(Adapter
);
1260 TcpipAcquireSpinLock(&Adapter
->Lock
, &OldIrql
);
1261 NdisHandle
= Adapter
->NdisHandle
;
1263 Adapter
->NdisHandle
= NULL
;
1264 TcpipReleaseSpinLock(&Adapter
->Lock
, OldIrql
);
1266 NdisCloseAdapter(&NdisStatus
, NdisHandle
);
1267 if (NdisStatus
== NDIS_STATUS_PENDING
) {
1268 TcpipWaitForSingleObject(&Adapter
->Event
,
1273 NdisStatus
= Adapter
->NdisStatus
;
1276 TcpipReleaseSpinLock(&Adapter
->Lock
, OldIrql
);
1278 FreeAdapter(Adapter
);
1285 LANUnregisterProtocol(VOID
)
1287 * FUNCTION: Unregisters this protocol driver with NDIS
1288 * NOTES: Does not care wether we are already registered
1291 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
1293 if (ProtocolRegistered
) {
1294 NDIS_STATUS NdisStatus
;
1295 PLIST_ENTRY CurrentEntry
;
1296 PLIST_ENTRY NextEntry
;
1297 PLAN_ADAPTER Current
;
1300 TcpipAcquireSpinLock(&AdapterListLock
, &OldIrql
);
1302 /* Search the list and remove every adapter we find */
1303 CurrentEntry
= AdapterListHead
.Flink
;
1304 while (CurrentEntry
!= &AdapterListHead
) {
1305 NextEntry
= CurrentEntry
->Flink
;
1306 Current
= CONTAINING_RECORD(CurrentEntry
, LAN_ADAPTER
, ListEntry
);
1308 LANUnregisterAdapter(Current
);
1309 CurrentEntry
= NextEntry
;
1312 TcpipReleaseSpinLock(&AdapterListLock
, OldIrql
);
1314 NdisDeregisterProtocol(&NdisStatus
, NdisProtocolHandle
);
1315 ProtocolRegistered
= FALSE
;
1321 ProtocolUnbindAdapter(
1322 PNDIS_STATUS Status
,
1323 NDIS_HANDLE ProtocolBindingContext
,
1324 NDIS_HANDLE UnbindContext
)
1326 /* We don't pend any unbinding so we can just ignore UnbindContext */
1327 *Status
= LANUnregisterAdapter((PLAN_ADAPTER
)ProtocolBindingContext
);
1330 NTSTATUS
LANRegisterProtocol(
1333 * FUNCTION: Registers this protocol driver with NDIS
1335 * Name = Name of this protocol driver
1337 * Status of operation
1340 NDIS_STATUS NdisStatus
;
1341 NDIS_PROTOCOL_CHARACTERISTICS ProtChars
;
1343 TI_DbgPrint(DEBUG_DATALINK
, ("Called.\n"));
1345 InitializeListHead(&AdapterListHead
);
1346 KeInitializeSpinLock(&AdapterListLock
);
1348 /* Set up protocol characteristics */
1349 RtlZeroMemory(&ProtChars
, sizeof(NDIS_PROTOCOL_CHARACTERISTICS
));
1350 ProtChars
.MajorNdisVersion
= NDIS_VERSION_MAJOR
;
1351 ProtChars
.MinorNdisVersion
= NDIS_VERSION_MINOR
;
1352 ProtChars
.Name
.Length
= Name
->Length
;
1353 ProtChars
.Name
.Buffer
= Name
->Buffer
;
1354 ProtChars
.Name
.MaximumLength
= Name
->MaximumLength
;
1355 ProtChars
.OpenAdapterCompleteHandler
= ProtocolOpenAdapterComplete
;
1356 ProtChars
.CloseAdapterCompleteHandler
= ProtocolCloseAdapterComplete
;
1357 ProtChars
.ResetCompleteHandler
= ProtocolResetComplete
;
1358 ProtChars
.RequestCompleteHandler
= ProtocolRequestComplete
;
1359 ProtChars
.SendCompleteHandler
= ProtocolSendComplete
;
1360 ProtChars
.TransferDataCompleteHandler
= ProtocolTransferDataComplete
;
1361 ProtChars
.ReceiveHandler
= ProtocolReceive
;
1362 ProtChars
.ReceiveCompleteHandler
= ProtocolReceiveComplete
;
1363 ProtChars
.StatusHandler
= ProtocolStatus
;
1364 ProtChars
.StatusCompleteHandler
= ProtocolStatusComplete
;
1365 ProtChars
.BindAdapterHandler
= ProtocolBindAdapter
;
1366 ProtChars
.PnPEventHandler
= ProtocolPnPEvent
;
1367 ProtChars
.UnbindAdapterHandler
= ProtocolUnbindAdapter
;
1368 ProtChars
.UnloadHandler
= LANUnregisterProtocol
;
1370 /* Try to register protocol */
1371 NdisRegisterProtocol(&NdisStatus
,
1372 &NdisProtocolHandle
,
1374 sizeof(NDIS_PROTOCOL_CHARACTERISTICS
));
1375 if (NdisStatus
!= NDIS_STATUS_SUCCESS
)
1377 TI_DbgPrint(DEBUG_DATALINK
, ("NdisRegisterProtocol failed, status 0x%x\n", NdisStatus
));
1378 return (NTSTATUS
)NdisStatus
;
1381 ProtocolRegistered
= TRUE
;
1383 return STATUS_SUCCESS
;