![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to tdikrnl.h CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [WindowsNT SDKs] / ntddk / src / network / inc|
Return to tdikrnl.h CVS log | Up to [WindowsNT SDKs] / ntddk / src / network / inc |
1.1 ! root 1: /*++ ! 2: ! 3: Copyright (c) 1989 Microsoft Corporation ! 4: ! 5: Module Name: ! 6: ! 7: tdikrnl.h ! 8: ! 9: Abstract: ! 10: ! 11: This header file contains interface definitions for NT transport ! 12: providers running in kernel mode. This interface is documented in the ! 13: NT Transport Driver Interface (TDI) Specification, Version 2. ! 14: ! 15: Author: ! 16: ! 17: Dave Beaver (dbeaver) 20 June 1991 ! 18: ! 19: Revision History: ! 20: ! 21: --*/ ! 22: ! 23: #ifndef _TDI_KRNL_ ! 24: #define _TDI_KRNL_ ! 25: ! 26: #include <tdi.h> // get the user mode includes ! 27: ! 28: // ! 29: // In this TDI, a kernel mode client calls TDI using IoCallDriver with the ! 30: // current Irp stack pointer set to 16 bytes of pointers to other structures. ! 31: // each of the supported NtDeviceIoControlFile analogs has a somehat different ! 32: // structure, laid out below. ! 33: // ! 34: // The IrpSP information passed by kernel mode clients looks like: ! 35: // ! 36: ! 37: typedef struct _TDI_REQUEST_KERNEL { ! 38: ULONG RequestFlags; ! 39: PTDI_CONNECTION_INFORMATION RequestConnectionInformation; ! 40: PTDI_CONNECTION_INFORMATION ReturnConnectionInformation; ! 41: PVOID RequestSpecific; ! 42: } TDI_REQUEST_KERNEL, *PTDI_REQUEST_KERNEL; ! 43: ! 44: // ! 45: // defined request codes for the kernel clients. We make these the same ! 46: // as the IOCTL codes mostly for convenience; either can be used with ! 47: // the same results. ! 48: // ! 49: ! 50: #define TDI_ASSOCIATE_ADDRESS (0x01) ! 51: #define TDI_DISASSOCIATE_ADDRESS (0x02) ! 52: #define TDI_CONNECT (0x03) ! 53: #define TDI_LISTEN (0x04) ! 54: #define TDI_ACCEPT (0x05) ! 55: #define TDI_DISCONNECT (0x06) ! 56: #define TDI_SEND (0x07) ! 57: #define TDI_RECEIVE (0x08) ! 58: #define TDI_SEND_DATAGRAM (0x09) ! 59: #define TDI_RECEIVE_DATAGRAM (0x0A) ! 60: #define TDI_SET_EVENT_HANDLER (0x0B) ! 61: #define TDI_QUERY_INFORMATION (0x0C) ! 62: #define TDI_SET_INFORMATION (0x0D) ! 63: #define TDI_ACTION (0x0E) ! 64: ! 65: // ! 66: // TdiOpenAddress (Not Used) ! 67: // TdiCloseAddress (Not Used) ! 68: // TdiOpenConnection (Not Used) ! 69: // TdiCloseConnection (Not Used) ! 70: // ! 71: ! 72: // ! 73: // some useful constants for comparison when determining the file type; ! 74: // not required. ! 75: // ! 76: ! 77: #define TDI_TRANSPORT_ADDRESS_FILE 1 ! 78: #define TDI_CONNECTION_FILE 2 ! 79: #define TDI_CONTROL_CHANNEL_FILE 3 ! 80: ! 81: // ! 82: // TdiAssociateAddress ! 83: // ! 84: ! 85: typedef struct _TDI_REQUEST_KERNEL_ASSOCIATE { ! 86: HANDLE AddressHandle; ! 87: } TDI_REQUEST_KERNEL_ASSOCIATE, *PTDI_REQUEST_KERNEL_ASSOCIATE; ! 88: ! 89: // ! 90: // TdiDisassociateAddress -- None supplied ! 91: // ! 92: ! 93: typedef TDI_REQUEST_KERNEL TDI_REQUEST_KERNEL_DISASSOCIATE, ! 94: *PTDI_REQUEST_KERNEL_DISASSOCIATE; ! 95: ! 96: // ! 97: // TdiConnect uses the structure given above (TDI_REQUEST_KERNEL); it's ! 98: // defined again below for convenience ! 99: // ! 100: ! 101: typedef TDI_REQUEST_KERNEL TDI_REQUEST_KERNEL_CONNECT, ! 102: *PTDI_REQUEST_KERNEL_CONNECT; ! 103: ! 104: // ! 105: // TdiDisconnect uses the structure given above (TDI_REQUEST_KERNEL); it's ! 106: // defined again below for convenience ! 107: // ! 108: ! 109: typedef TDI_REQUEST_KERNEL TDI_REQUEST_KERNEL_DISCONNECT, ! 110: *PTDI_REQUEST_KERNEL_DISCONNECT; ! 111: ! 112: // ! 113: // TdiListen uses the structure given above (TDI_REQUEST_KERNEL); it's ! 114: // defined again below for convenience ! 115: // ! 116: ! 117: typedef TDI_REQUEST_KERNEL TDI_REQUEST_KERNEL_LISTEN, ! 118: *PTDI_REQUEST_KERNEL_LISTEN; ! 119: ! 120: // ! 121: // TdiAccept ! 122: // ! 123: ! 124: typedef struct _TDI_REQUEST_KERNEL_ACCEPT { ! 125: PTDI_CONNECTION_INFORMATION RequestConnectionInformation; ! 126: PTDI_CONNECTION_INFORMATION ReturnConnectionInformation; ! 127: } TDI_REQUEST_KERNEL_ACCEPT, *PTDI_REQUEST_KERNEL_ACCEPT; ! 128: ! 129: // ! 130: // TdiSend ! 131: // ! 132: ! 133: typedef struct _TDI_REQUEST_KERNEL_SEND { ! 134: ULONG SendLength; ! 135: ULONG SendFlags; ! 136: } TDI_REQUEST_KERNEL_SEND, *PTDI_REQUEST_KERNEL_SEND; ! 137: ! 138: // ! 139: // TdiReceive ! 140: // ! 141: ! 142: typedef struct _TDI_REQUEST_KERNEL_RECEIVE { ! 143: ULONG ReceiveLength; ! 144: ULONG ReceiveFlags; ! 145: } TDI_REQUEST_KERNEL_RECEIVE, *PTDI_REQUEST_KERNEL_RECEIVE; ! 146: ! 147: // ! 148: // TdiSendDatagram ! 149: // ! 150: ! 151: typedef struct _TDI_REQUEST_KERNEL_SENDDG { ! 152: ULONG SendLength; ! 153: PTDI_CONNECTION_INFORMATION SendDatagramInformation; ! 154: } TDI_REQUEST_KERNEL_SENDDG, *PTDI_REQUEST_KERNEL_SENDDG; ! 155: ! 156: // ! 157: // TdiReceiveDatagram ! 158: // ! 159: ! 160: typedef struct _TDI_REQUEST_KERNEL_RECEIVEDG { ! 161: ULONG ReceiveLength; ! 162: PTDI_CONNECTION_INFORMATION ReceiveDatagramInformation; ! 163: PTDI_CONNECTION_INFORMATION ReturnDatagramInformation; ! 164: ULONG ReceiveFlags; ! 165: } TDI_REQUEST_KERNEL_RECEIVEDG, *PTDI_REQUEST_KERNEL_RECEIVEDG; ! 166: ! 167: // ! 168: // TdiSetEventHandler ! 169: // ! 170: ! 171: typedef struct _TDI_REQUEST_KERNEL_SET_EVENT { ! 172: int EventType; ! 173: PVOID EventHandler; ! 174: PVOID EventContext; ! 175: } TDI_REQUEST_KERNEL_SET_EVENT, *PTDI_REQUEST_KERNEL_SET_EVENT; ! 176: ! 177: // ! 178: // TdiQueryInformation ! 179: // ! 180: ! 181: typedef struct _TDI_REQUEST_KERNEL_QUERY_INFO { ! 182: int QueryType; ! 183: PTDI_CONNECTION_INFORMATION RequestConnectionInformation; ! 184: } TDI_REQUEST_KERNEL_QUERY_INFORMATION, *PTDI_REQUEST_KERNEL_QUERY_INFORMATION; ! 185: ! 186: // ! 187: // TdiSetInformation ! 188: // ! 189: ! 190: typedef struct _TDI_REQUEST_KERNEL_SET_INFO { ! 191: int SetType; ! 192: PTDI_CONNECTION_INFORMATION RequestConnectionInformation; ! 193: } TDI_REQUEST_KERNEL_SET_INFORMATION, *PTDI_REQUEST_KERNEL_SET_INFORMATION; ! 194: ! 195: // ! 196: // Event types that are known ! 197: // ! 198: ! 199: #define TDI_EVENT_CONNECT ((USHORT)0) // TDI_IND_CONNECT event handler. ! 200: #define TDI_EVENT_DISCONNECT ((USHORT)1) // TDI_IND_DISCONNECT event handler. ! 201: #define TDI_EVENT_ERROR ((USHORT)2) // TDI_IND_ERROR event handler. ! 202: #define TDI_EVENT_RECEIVE ((USHORT)3) // TDI_IND_RECEIVE event handler. ! 203: #define TDI_EVENT_RECEIVE_DATAGRAM ((USHORT)4) // TDI_IND_RECEIVE_DATAGRAM event handler. ! 204: #define TDI_EVENT_RECEIVE_EXPEDITED ((USHORT)5) // TDI_IND_RECEIVE_EXPEDITED event handler. ! 205: #define TDI_EVENT_SEND_POSSIBLE ((USHORT)6) // TDI_IND_SEND_POSSIBLE event handler ! 206: ! 207: // ! 208: // indicate connection event prototype. This is invoked when a request for ! 209: // connection has been received by the provider and the user wishes to either ! 210: // accept or reject that request. ! 211: // ! 212: ! 213: typedef ! 214: NTSTATUS ! 215: (*PTDI_IND_CONNECT)( ! 216: IN PVOID TdiEventContext, ! 217: IN int RemoteAddressLength, ! 218: IN PVOID RemoteAddress, ! 219: IN int UserDataLength, ! 220: IN PVOID UserData, ! 221: IN int OptionsLength, ! 222: IN PVOID Options, ! 223: OUT CONNECTION_CONTEXT *ConnectionContext, ! 224: OUT PIRP *AcceptIrp ! 225: ) ! 226: ; ! 227: ! 228: NTSTATUS ! 229: TdiDefaultConnectHandler ( ! 230: IN PVOID TdiEventContext, ! 231: IN int RemoteAddressLength, ! 232: IN PVOID RemoteAddress, ! 233: IN int UserDataLength, ! 234: IN PVOID UserData, ! 235: IN int OptionsLength, ! 236: IN PVOID Options, ! 237: OUT CONNECTION_CONTEXT *ConnectionContext, ! 238: OUT PIRP *AcceptIrp ! 239: ); ! 240: ! 241: // ! 242: // Disconnection indication prototype. This is invoked when a connection is ! 243: // being disconnected for a reason other than the user requesting it. Note that ! 244: // this is a change from TDI V1, which indicated only when the remote caused ! 245: // a disconnection. Any non-directed disconnection will cause this indication. ! 246: // ! 247: ! 248: typedef ! 249: NTSTATUS ! 250: (*PTDI_IND_DISCONNECT)( ! 251: IN PVOID TdiEventContext, ! 252: IN CONNECTION_CONTEXT ConnectionContext, ! 253: IN int DisconnectDataLength, ! 254: IN PVOID DisconnectData, ! 255: IN int DisconnectInformationLength, ! 256: IN PVOID DisconnectInformation, ! 257: IN ULONG DisconnectFlags ! 258: ); ! 259: ! 260: NTSTATUS ! 261: TdiDefaultDisconnectHandler ( ! 262: IN PVOID TdiEventContext, ! 263: IN CONNECTION_CONTEXT ConnectionContext, ! 264: IN int DisconnectDataLength, ! 265: IN PVOID DisconnectData, ! 266: IN int DisconnectInformationLength, ! 267: IN PVOID DisconnectInformation, ! 268: IN ULONG DisconnectFlags ! 269: ); ! 270: ! 271: // ! 272: // A protocol error has occurred when this indication happens. This indication ! 273: // occurs only for errors of the worst type; the address this indication is ! 274: // delivered to is no longer usable for protocol-related operations, and ! 275: // should not be used for operations henceforth. All connections associated ! 276: // it are invalid. ! 277: // For NetBIOS-type providers, this indication is also delivered when a name ! 278: // in conflict or duplicate name occurs. ! 279: // ! 280: ! 281: typedef ! 282: NTSTATUS ! 283: (*PTDI_IND_ERROR)( ! 284: IN PVOID TdiEventContext, // the endpoint's file object. ! 285: IN NTSTATUS Status // status code indicating error type. ! 286: ); ! 287: ! 288: NTSTATUS ! 289: TdiDefaultErrorHandler ( ! 290: IN PVOID TdiEventContext, // the endpoint's file object. ! 291: IN NTSTATUS Status // status code indicating error type. ! 292: ); ! 293: ! 294: // ! 295: // TDI_IND_RECEIVE indication handler definition. This client routine is ! 296: // called by the transport provider when a connection-oriented TSDU is received ! 297: // that should be presented to the client. ! 298: // ! 299: ! 300: typedef ! 301: NTSTATUS ! 302: (*PTDI_IND_RECEIVE)( ! 303: IN PVOID TdiEventContext, ! 304: IN CONNECTION_CONTEXT ConnectionContext, ! 305: IN ULONG ReceiveFlags, ! 306: IN ULONG BytesIndicated, ! 307: IN ULONG BytesAvailable, ! 308: OUT ULONG *BytesTaken, ! 309: IN PVOID Tsdu, // pointer describing this TSDU, typically a lump of bytes ! 310: OUT PIRP *IoRequestPacket // TdiReceive IRP if MORE_PROCESSING_REQUIRED. ! 311: ); ! 312: ! 313: NTSTATUS ! 314: TdiDefaultReceiveHandler ( ! 315: IN PVOID TdiEventContext, ! 316: IN CONNECTION_CONTEXT ConnectionContext, ! 317: IN ULONG ReceiveFlags, ! 318: IN ULONG BytesIndicated, ! 319: IN ULONG BytesAvailable, ! 320: OUT ULONG *BytesTaken, ! 321: IN PVOID Tsdu, // pointer describing this TSDU, typically a lump of bytes ! 322: OUT PIRP *IoRequestPacket // TdiReceive IRP if MORE_PROCESSING_REQUIRED. ! 323: ); ! 324: ! 325: // ! 326: // TDI_IND_RECEIVE_DATAGRAM indication handler definition. This client routine ! 327: // is called by the transport provider when a connectionless TSDU is received ! 328: // that should be presented to the client. ! 329: // ! 330: ! 331: typedef ! 332: NTSTATUS ! 333: (*PTDI_IND_RECEIVE_DATAGRAM)( ! 334: IN PVOID TdiEventContext, // the event context ! 335: IN int SourceAddressLength, // length of the originator of the datagram ! 336: IN PVOID SourceAddress, // string describing the originator of the datagram ! 337: IN int OptionsLength, // options for the receive ! 338: IN PVOID Options, // ! 339: IN ULONG ReceiveDatagramFlags, // ! 340: IN ULONG BytesIndicated, // number of bytes this indication ! 341: IN ULONG BytesAvailable, // number of bytes in complete Tsdu ! 342: OUT ULONG *BytesTaken, // number of bytes used ! 343: IN PVOID Tsdu, // pointer describing this TSDU, typically a lump of bytes ! 344: OUT PIRP *IoRequestPacket // TdiReceive IRP if MORE_PROCESSING_REQUIRED. ! 345: ); ! 346: ! 347: NTSTATUS ! 348: TdiDefaultRcvDatagramHandler ( ! 349: IN PVOID TdiEventContext, // the event context ! 350: IN int SourceAddressLength, // length of the originator of the datagram ! 351: IN PVOID SourceAddress, // string describing the originator of the datagram ! 352: IN int OptionsLength, // options for the receive ! 353: IN PVOID Options, // ! 354: IN ULONG ReceiveDatagramFlags, // ! 355: IN ULONG BytesIndicated, // number of bytes this indication ! 356: IN ULONG BytesAvailable, // number of bytes in complete Tsdu ! 357: OUT ULONG *BytesTaken, // number of bytes used ! 358: IN PVOID Tsdu, // pointer describing this TSDU, typically a lump of bytes ! 359: OUT PIRP *IoRequestPacket // TdiReceive IRP if MORE_PROCESSING_REQUIRED. ! 360: ); ! 361: ! 362: // ! 363: // This indication is delivered if expedited data is received on the connection. ! 364: // This will only occur in providers that support expedited data. ! 365: // ! 366: ! 367: typedef ! 368: NTSTATUS ! 369: (*PTDI_IND_RECEIVE_EXPEDITED)( ! 370: IN PVOID TdiEventContext, ! 371: IN CONNECTION_CONTEXT ConnectionContext, ! 372: IN ULONG ReceiveFlags, // ! 373: IN ULONG BytesIndicated, // number of bytes in this indication ! 374: IN ULONG BytesAvailable, // number of bytes in complete Tsdu ! 375: OUT ULONG *BytesTaken, // number of bytes used by indication routine ! 376: IN PVOID Tsdu, // pointer describing this TSDU, typically a lump of bytes ! 377: OUT PIRP *IoRequestPacket // TdiReceive IRP if MORE_PROCESSING_REQUIRED. ! 378: ); ! 379: ! 380: NTSTATUS ! 381: TdiDefaultRcvExpeditedHandler ( ! 382: IN PVOID TdiEventContext, ! 383: IN CONNECTION_CONTEXT ConnectionContext, ! 384: IN ULONG ReceiveFlags, // ! 385: IN ULONG BytesIndicated, // number of bytes in this indication ! 386: IN ULONG BytesAvailable, // number of bytes in complete Tsdu ! 387: OUT ULONG *BytesTaken, // number of bytes used by indication routine ! 388: IN PVOID Tsdu, // pointer describing this TSDU, typically a lump of bytes ! 389: OUT PIRP *IoRequestPacket // TdiReceive IRP if MORE_PROCESSING_REQUIRED. ! 390: ); ! 391: ! 392: // ! 393: // This indication is delivered if there is room for a send in the buffer of ! 394: // a buffering protocol. ! 395: // ! 396: ! 397: typedef ! 398: NTSTATUS ! 399: (*PTDI_IND_SEND_POSSIBLE)( ! 400: IN PVOID TdiEventContext, ! 401: IN PVOID ConnectionContext, ! 402: IN ULONG BytesAvailable); ! 403: ! 404: NTSTATUS ! 405: TdiDefaultSendPossibleHandler ( ! 406: IN PVOID TdiEventContext, ! 407: IN PVOID ConnectionContext, ! 408: IN ULONG BytesAvailable); ! 409: ! 410: // ! 411: // defined MACROS to allow the kernel mode client to easily build an IRP for ! 412: // any function. ! 413: // ! 414: ! 415: #define TdiBuildAssociateAddress(Irp, DevObj, FileObj, CompRoutine, Contxt, AddrHandle) \ ! 416: { \ ! 417: PTDI_REQUEST_KERNEL_ASSOCIATE p; \ ! 418: PIO_STACK_LOCATION _IRPSP; \ ! 419: if ( CompRoutine != NULL) { \ ! 420: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 421: } else { \ ! 422: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 423: } \ ! 424: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 425: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 426: _IRPSP->MinorFunction = TDI_ASSOCIATE_ADDRESS; \ ! 427: _IRPSP->DeviceObject = DevObj; \ ! 428: _IRPSP->FileObject = FileObj; \ ! 429: p = (PTDI_REQUEST_KERNEL_ASSOCIATE)&_IRPSP->Parameters; \ ! 430: p->AddressHandle = (HANDLE)(AddrHandle); \ ! 431: } ! 432: ! 433: #define TdiBuildDisassociateAddress(Irp, DevObj, FileObj, CompRoutine, Contxt) \ ! 434: { \ ! 435: PTDI_REQUEST_KERNEL_DISASSOCIATE p; \ ! 436: PIO_STACK_LOCATION _IRPSP; \ ! 437: if ( CompRoutine != NULL) { \ ! 438: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 439: } else { \ ! 440: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 441: } \ ! 442: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 443: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 444: _IRPSP->MinorFunction = TDI_DISASSOCIATE_ADDRESS; \ ! 445: _IRPSP->DeviceObject = DevObj; \ ! 446: _IRPSP->FileObject = FileObj; \ ! 447: p = (PTDI_REQUEST_KERNEL_DISASSOCIATE)&_IRPSP->Parameters; \ ! 448: } ! 449: ! 450: #define TdiBuildConnect(Irp, DevObj, FileObj, CompRoutine, Contxt, Time, RequestConnectionInfo, ReturnConnectionInfo)\ ! 451: { \ ! 452: PTDI_REQUEST_KERNEL p; \ ! 453: PIO_STACK_LOCATION _IRPSP; \ ! 454: if ( CompRoutine != NULL) { \ ! 455: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 456: } else { \ ! 457: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 458: } \ ! 459: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 460: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 461: _IRPSP->MinorFunction = TDI_CONNECT; \ ! 462: _IRPSP->DeviceObject = DevObj; \ ! 463: _IRPSP->FileObject = FileObj; \ ! 464: p = (PTDI_REQUEST_KERNEL)&_IRPSP->Parameters; \ ! 465: p->RequestConnectionInformation = RequestConnectionInfo; \ ! 466: p->ReturnConnectionInformation = ReturnConnectionInfo; \ ! 467: p->RequestSpecific = (PVOID)Time; \ ! 468: } ! 469: ! 470: #define TdiBuildListen(Irp, DevObj, FileObj, CompRoutine, Contxt, Flags, RequestConnectionInfo, ReturnConnectionInfo)\ ! 471: { \ ! 472: PTDI_REQUEST_KERNEL p; \ ! 473: PIO_STACK_LOCATION _IRPSP; \ ! 474: if ( CompRoutine != NULL) { \ ! 475: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 476: } else { \ ! 477: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 478: } \ ! 479: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 480: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 481: _IRPSP->MinorFunction = TDI_LISTEN; \ ! 482: _IRPSP->DeviceObject = DevObj; \ ! 483: _IRPSP->FileObject = FileObj; \ ! 484: p = (PTDI_REQUEST_KERNEL)&_IRPSP->Parameters; \ ! 485: p->RequestFlags = Flags; \ ! 486: p->RequestConnectionInformation = RequestConnectionInfo; \ ! 487: p->ReturnConnectionInformation = ReturnConnectionInfo; \ ! 488: } ! 489: ! 490: #define TdiBuildAccept(Irp, DevObj, FileObj, CompRoutine, Contxt, RequestConnectionInfo, ReturnConnectionInfo)\ ! 491: { \ ! 492: PTDI_REQUEST_KERNEL_ACCEPT p; \ ! 493: PIO_STACK_LOCATION _IRPSP; \ ! 494: if ( CompRoutine != NULL) { \ ! 495: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 496: } else { \ ! 497: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 498: } \ ! 499: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 500: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 501: _IRPSP->MinorFunction = TDI_ACCEPT; \ ! 502: _IRPSP->DeviceObject = DevObj; \ ! 503: _IRPSP->FileObject = FileObj; \ ! 504: p = (PTDI_REQUEST_KERNEL_ACCEPT)&_IRPSP->Parameters; \ ! 505: p->RequestConnectionInformation = RequestConnectionInfo; \ ! 506: p->ReturnConnectionInformation = ReturnConnectionInfo; \ ! 507: } ! 508: ! 509: #define TdiBuildDisconnect(Irp, DevObj, FileObj, CompRoutine, Contxt, Time, Flags, RequestConnectionInfo, ReturnConnectionInfo)\ ! 510: { \ ! 511: PTDI_REQUEST_KERNEL p; \ ! 512: PIO_STACK_LOCATION _IRPSP; \ ! 513: if ( CompRoutine != NULL) { \ ! 514: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 515: } else { \ ! 516: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 517: } \ ! 518: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 519: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 520: _IRPSP->MinorFunction = TDI_DISCONNECT; \ ! 521: _IRPSP->DeviceObject = DevObj; \ ! 522: _IRPSP->FileObject = FileObj; \ ! 523: p = (PTDI_REQUEST_KERNEL)&_IRPSP->Parameters; \ ! 524: p->RequestFlags = Flags; \ ! 525: p->RequestConnectionInformation = RequestConnectionInfo; \ ! 526: p->ReturnConnectionInformation = ReturnConnectionInfo; \ ! 527: p->RequestSpecific = (PVOID)Time; \ ! 528: } ! 529: ! 530: #define TdiBuildReceive(Irp, DevObj, FileObj, CompRoutine, Contxt, MdlAddr, InFlags, ReceiveLen)\ ! 531: { \ ! 532: PTDI_REQUEST_KERNEL_RECEIVE p; \ ! 533: PIO_STACK_LOCATION _IRPSP; \ ! 534: if ( CompRoutine != NULL) { \ ! 535: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 536: } else { \ ! 537: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 538: } \ ! 539: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 540: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 541: _IRPSP->MinorFunction = TDI_RECEIVE; \ ! 542: _IRPSP->DeviceObject = DevObj; \ ! 543: _IRPSP->FileObject = FileObj; \ ! 544: p = (PTDI_REQUEST_KERNEL_RECEIVE)&_IRPSP->Parameters; \ ! 545: p->ReceiveFlags = InFlags; \ ! 546: p->ReceiveLength = ReceiveLen; \ ! 547: Irp->MdlAddress = MdlAddr; \ ! 548: } ! 549: ! 550: #define TdiBuildSend(Irp, DevObj, FileObj, CompRoutine, Contxt, MdlAddr, InFlags, SendLen)\ ! 551: { \ ! 552: PTDI_REQUEST_KERNEL_SEND p; \ ! 553: PIO_STACK_LOCATION _IRPSP; \ ! 554: if ( CompRoutine != NULL) { \ ! 555: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 556: } else { \ ! 557: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 558: } \ ! 559: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 560: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 561: _IRPSP->MinorFunction = TDI_SEND; \ ! 562: _IRPSP->DeviceObject = DevObj; \ ! 563: _IRPSP->FileObject = FileObj; \ ! 564: p = (PTDI_REQUEST_KERNEL_SEND)&_IRPSP->Parameters; \ ! 565: p->SendFlags = InFlags; \ ! 566: p->SendLength = SendLen; \ ! 567: Irp->MdlAddress = MdlAddr; \ ! 568: } ! 569: ! 570: #define TdiBuildSendDatagram(Irp, DevObj, FileObj, CompRoutine, Contxt, MdlAddr, SendLen, SendDatagramInfo)\ ! 571: { \ ! 572: PTDI_REQUEST_KERNEL_SENDDG p; \ ! 573: PIO_STACK_LOCATION _IRPSP; \ ! 574: if ( CompRoutine != NULL) { \ ! 575: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 576: } else { \ ! 577: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 578: } \ ! 579: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 580: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 581: _IRPSP->MinorFunction = TDI_SEND_DATAGRAM; \ ! 582: _IRPSP->DeviceObject = DevObj; \ ! 583: _IRPSP->FileObject = FileObj; \ ! 584: p = (PTDI_REQUEST_KERNEL_SENDDG)&_IRPSP->Parameters; \ ! 585: p->SendLength = SendLen; \ ! 586: p->SendDatagramInformation = SendDatagramInfo; \ ! 587: Irp->MdlAddress = MdlAddr; \ ! 588: } ! 589: ! 590: #define TdiBuildReceiveDatagram(Irp, DevObj, FileObj, CompRoutine, Contxt, MdlAddr, ReceiveLen, ReceiveDatagramInfo, ReturnInfo, InFlags)\ ! 591: { \ ! 592: PTDI_REQUEST_KERNEL_RECEIVEDG p; \ ! 593: PIO_STACK_LOCATION _IRPSP; \ ! 594: if ( CompRoutine != NULL) { \ ! 595: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 596: } else { \ ! 597: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 598: } \ ! 599: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 600: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 601: _IRPSP->MinorFunction = TDI_RECEIVE_DATAGRAM; \ ! 602: _IRPSP->DeviceObject = DevObj; \ ! 603: _IRPSP->FileObject = FileObj; \ ! 604: p = (PTDI_REQUEST_KERNEL_RECEIVEDG)&_IRPSP->Parameters; \ ! 605: p->ReceiveLength = ReceiveLen; \ ! 606: p->ReceiveDatagramInformation = ReceiveDatagramInfo; \ ! 607: p->ReturnDatagramInformation = ReturnInfo; \ ! 608: p->ReceiveFlags = InFlags; \ ! 609: Irp->MdlAddress = MdlAddr; \ ! 610: } ! 611: ! 612: #define TdiBuildSetEventHandler(Irp, DevObj, FileObj, CompRoutine, Contxt, InEventType, InEventHandler, InEventContext) \ ! 613: { \ ! 614: PTDI_REQUEST_KERNEL_SET_EVENT p; \ ! 615: PIO_STACK_LOCATION _IRPSP; \ ! 616: if ( CompRoutine != NULL) { \ ! 617: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 618: } else { \ ! 619: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 620: } \ ! 621: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 622: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 623: _IRPSP->MinorFunction = TDI_SET_EVENT_HANDLER; \ ! 624: _IRPSP->DeviceObject = DevObj; \ ! 625: _IRPSP->FileObject = FileObj; \ ! 626: p = (PTDI_REQUEST_KERNEL_SET_EVENT)&_IRPSP->Parameters; \ ! 627: p->EventType = InEventType; \ ! 628: p->EventHandler = (PVOID)InEventHandler; \ ! 629: p->EventContext = (PVOID)InEventContext; \ ! 630: } ! 631: ! 632: #define TdiBuildQueryInformation(Irp, DevObj, FileObj, CompRoutine, Contxt, QType, MdlAddr)\ ! 633: { \ ! 634: PTDI_REQUEST_KERNEL_QUERY_INFORMATION p; \ ! 635: PIO_STACK_LOCATION _IRPSP; \ ! 636: Irp->MdlAddress = MdlAddr; \ ! 637: if ( CompRoutine != NULL) { \ ! 638: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 639: } else { \ ! 640: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 641: } \ ! 642: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 643: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 644: _IRPSP->MinorFunction = TDI_QUERY_INFORMATION; \ ! 645: _IRPSP->DeviceObject = DevObj; \ ! 646: _IRPSP->FileObject = FileObj; \ ! 647: p = (PTDI_REQUEST_KERNEL_QUERY_INFORMATION)&_IRPSP->Parameters; \ ! 648: p->QueryType = (ULONG)QType; \ ! 649: p->RequestConnectionInformation = NULL; \ ! 650: } ! 651: ! 652: ! 653: #define TdiBuildSetInformation(Irp, DevObj, FileObj, CompRoutine, Contxt, SType, MdlAddr)\ ! 654: { \ ! 655: PTDI_REQUEST_KERNEL_SET_INFORMATION p; \ ! 656: PIO_STACK_LOCATION _IRPSP; \ ! 657: Irp->MdlAddress = MdlAddr; \ ! 658: if ( CompRoutine != NULL) { \ ! 659: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 660: } else { \ ! 661: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 662: } \ ! 663: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 664: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 665: _IRPSP->MinorFunction = TDI_SET_INFORMATION; \ ! 666: _IRPSP->DeviceObject = DevObj; \ ! 667: _IRPSP->FileObject = FileObj; \ ! 668: p = (PTDI_REQUEST_KERNEL_SET_INFORMATION)&_IRPSP->Parameters; \ ! 669: p->SetType = (ULONG)SType; \ ! 670: p->RequestConnectionInformation = NULL; \ ! 671: } ! 672: ! 673: #define TdiBuildAction(Irp, DevObj, FileObj, CompRoutine, Contxt, MdlAddr)\ ! 674: { \ ! 675: PIO_STACK_LOCATION _IRPSP; \ ! 676: if ( CompRoutine != NULL) { \ ! 677: IoSetCompletionRoutine( Irp, CompRoutine, Contxt, TRUE, TRUE, TRUE);\ ! 678: } else { \ ! 679: IoSetCompletionRoutine( Irp, NULL, NULL, FALSE, FALSE, FALSE); \ ! 680: } \ ! 681: _IRPSP = IoGetNextIrpStackLocation (Irp); \ ! 682: _IRPSP->MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL; \ ! 683: _IRPSP->MinorFunction = TDI_ACTION; \ ! 684: _IRPSP->DeviceObject = DevObj; \ ! 685: _IRPSP->FileObject = FileObj; \ ! 686: Irp->MdlAddress = MdlAddr; \ ! 687: } ! 688: ! 689: // ! 690: // definitions for the helper routines for TDI compliant transports and clients ! 691: // ! 692: // Note that the IOCTL used here for the Irp Function is not real; it is used ! 693: // to avoid this IO routine having to map buffers (which we don't want). ! 694: // ! 695: //PIRP ! 696: //TdiBuildInternalDeviceControlIrp ( ! 697: // IN CCHAR IrpSubFunction, ! 698: // IN PDEVICE_OBJECT DeviceObject, ! 699: // IN PFILE_OBJECT FileObject, ! 700: // IN PKEVENT Event, ! 701: // IN PIO_STATUS_BLOCK IoStatusBlock ! 702: // ); ! 703: ! 704: #define TdiBuildInternalDeviceControlIrp(IrpSubFunction,DeviceObject,FileObject,Event,IoStatusBlock) \ ! 705: IoBuildDeviceIoControlRequest (\ ! 706: 0x00000003,\ ! 707: DeviceObject, \ ! 708: NULL, \ ! 709: 0, \ ! 710: NULL, \ ! 711: 0, \ ! 712: TRUE, \ ! 713: Event, \ ! 714: IoStatusBlock) ! 715: ! 716: ! 717: // ! 718: // VOID ! 719: // TdiCopyLookaheadData( ! 720: // IN PVOID Destination, ! 721: // IN PVOID Source, ! 722: // IN ULONG Length, ! 723: // IN ULONG ReceiveFlags ! 724: // ); ! 725: // ! 726: ! 727: #ifdef _M_IX86 ! 728: #define TdiCopyLookaheadData(_Destination,_Source,_Length,_ReceiveFlags) \ ! 729: RtlCopyMemory(_Destination,_Source,_Length) ! 730: #else ! 731: #define TdiCopyLookaheadData(_Destination,_Source,_Length,_ReceiveFlags) { \ ! 732: if ((_ReceiveFlags) & TDI_RECEIVE_COPY_LOOKAHEAD) { \ ! 733: RtlCopyMemory(_Destination,_Source,_Length); \ ! 734: } else { \ ! 735: PUCHAR _Src = (_Source); \ ! 736: PUCHAR _Dest = (_Destination); \ ! 737: PUCHAR _End = _Dest + (_Length); \ ! 738: while (_Dest < _End) { \ ! 739: *_Dest++ = *_Src++; \ ! 740: } \ ! 741: } \ ! 742: } ! 743: #endif ! 744: ! 745: ! 746: NTSTATUS ! 747: TdiMapUserRequest( ! 748: IN PDEVICE_OBJECT DeviceObject, ! 749: IN PIRP Irp, ! 750: IN PIO_STACK_LOCATION IrpSp ! 751: ); ! 752: ! 753: VOID ! 754: TdiMapBuffer ( ! 755: IN PMDL MdlChain ! 756: ); ! 757: ! 758: VOID ! 759: TdiUnmapBuffer ( ! 760: IN PMDL MdlChain ! 761: ); ! 762: ! 763: NTSTATUS ! 764: TdiCopyBufferToMdl ( ! 765: IN PVOID SourceBuffer, ! 766: IN ULONG SourceOffset, ! 767: IN ULONG SourceBytesToCopy, ! 768: IN PMDL DestinationMdlChain, ! 769: IN ULONG DestinationOffset, ! 770: IN PULONG BytesCopied ! 771: ); ! 772: ! 773: NTSTATUS ! 774: TdiCopyMdlToBuffer( ! 775: IN PMDL SourceMdlChain, ! 776: IN ULONG SourceOffset, ! 777: IN PVOID DestinationBuffer, ! 778: IN ULONG DestinationOffset, ! 779: IN ULONG DestinationBufferSize, ! 780: OUT PULONG BytesCopied ! 781: ); ! 782: ! 783: VOID ! 784: TdiBuildNetbiosAddress ( ! 785: IN PUCHAR NetbiosName, ! 786: IN BOOLEAN IsGroupName, ! 787: IN OUT PTA_NETBIOS_ADDRESS NetworkName ! 788: ); ! 789: ! 790: NTSTATUS ! 791: TdiBuildNetbiosAddressEa ( ! 792: IN PUCHAR Buffer, ! 793: IN BOOLEAN IsGroupName, ! 794: IN PUCHAR NetbiosName ! 795: ); ! 796: ! 797: //++ ! 798: // ! 799: // VOID ! 800: // TdiCompleteRequest ( ! 801: // IN PIRP Irp, ! 802: // IN NTSTATUS Status ! 803: // ); ! 804: // ! 805: // Routine Description: ! 806: // ! 807: // This routine is used to complete an IRP with the indicated ! 808: // status. ! 809: // ! 810: // Arguments: ! 811: // ! 812: // Irp - Supplies a pointer to the Irp to complete ! 813: // ! 814: // Status - Supplies the completion status for the Irp ! 815: // ! 816: // Return Value: ! 817: // ! 818: // None. ! 819: // ! 820: //-- ! 821: ! 822: #define TdiCompleteRequest(IRP,STATUS) { \ ! 823: (IRP)->IoStatus.Status = (STATUS); \ ! 824: IoCompleteRequest( (IRP), IO_NETWORK_INCREMENT ); \ ! 825: } ! 826: ! 827: #endif // _TDI_KRNL_
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.