ReactOS 0.4.16-dev-2293-g4d8327b
Functions
tdi_proto.h File Reference
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions

NTSTATUS TdiConnect (PIRP *PendingIrp, PFILE_OBJECT ConnectionObject, PTDI_CONNECTION_INFORMATION ConnectionCallInfo, PTDI_CONNECTION_INFORMATION ConnectionReturnInfo, PIO_COMPLETION_ROUTINE CompletionRoutine, PVOID CompletionContext)
 Connect a connection endpoint to a remote peer.
 
NTSTATUS TdiOpenConnectionEndpointFile (PUNICODE_STRING DeviceName, PHANDLE ConnectionHandle, PFILE_OBJECT *ConnectionObject)
 Opens a connection endpoint file object.
 
NTSTATUS TdiCloseDevice (HANDLE Handle, PFILE_OBJECT FileObject)
 
NTSTATUS TdiDisconnect (PIRP *Irp, PFILE_OBJECT TransportObject, PLARGE_INTEGER Time, USHORT Flags, PIO_COMPLETION_ROUTINE CompletionRoutine, PVOID CompletionContext, PTDI_CONNECTION_INFORMATION RequestConnectionInfo, PTDI_CONNECTION_INFORMATION ReturnConnectionInfo)
 
NTSTATUS TdiQueryInformation (PFILE_OBJECT FileObject, LONG QueryType, PMDL MdlBuffer)
 Query for information.
 
NTSTATUS TdiSetEventHandler (PFILE_OBJECT FileObject, LONG EventType, PVOID Handler, PVOID Context)
 Sets or resets an event handler.
 
NTSTATUS TdiQueryDeviceControl (PFILE_OBJECT FileObject, ULONG IoControlCode, PVOID InputBuffer, ULONG InputBufferLength, PVOID OutputBuffer, ULONG OutputBufferLength, PULONG Return)
 Queries a device for information.
 

Function Documentation

◆ TdiCloseDevice()

NTSTATUS TdiCloseDevice ( HANDLE  Handle,
PFILE_OBJECT  FileObject 
)

Definition at line 158 of file tditest.c.

161{
162 if (FileObject)
163 ObDereferenceObject(FileObject);
164
165 if (Handle)
166 ZwClose(Handle);
167
168 return STATUS_SUCCESS;
169}
Handle
ULONG Handle
Definition: gdb_input.c:15
ZwClose
NTSYSAPI NTSTATUS NTAPI ZwClose(_In_ HANDLE Handle)
STATUS_SUCCESS
#define STATUS_SUCCESS
Definition: shellext.h:65
FileObject
_In_ WDFREQUEST _In_ WDFFILEOBJECT FileObject
Definition: wdfdevice.h:550
ObDereferenceObject
#define ObDereferenceObject
Definition: obfuncs.h:203

Referenced by TdiUnload().

◆ TdiConnect()

NTSTATUS TdiConnect ( PIRP *  Irp,
PFILE_OBJECT  ConnectionObject,
PTDI_CONNECTION_INFORMATION  ConnectionCallInfo,
PTDI_CONNECTION_INFORMATION  ConnectionReturnInfo,
PIO_COMPLETION_ROUTINE  CompletionRoutine,
PVOID  CompletionContext 
)

Connect a connection endpoint to a remote peer.

Parameters
ConnectionObject= Pointer to connection endpoint file object
RemoteAddress= Pointer to remote address
Returns
Status of operation

Definition at line 311 of file tdi.c.

326{
327 PDEVICE_OBJECT DeviceObject;
328
329 DPRINT("Called\n");
330
331 if (!ConnectionObject) {
332 DPRINT("Bad connection object.\n");
333 return STATUS_INVALID_PARAMETER;
334 }
335
336 DeviceObject = IoGetRelatedDeviceObject(ConnectionObject);
337 if (!DeviceObject) {
338 DPRINT("Bad device object.\n");
339 return STATUS_INVALID_PARAMETER;
340 }
341
342 *Irp = TdiBuildInternalDeviceControlIrp(TDI_CONNECT,
343 DeviceObject,
344 ConnectionObject,
345 NULL,
346 NULL);
347 if (!*Irp) {
348 return STATUS_INSUFFICIENT_RESOURCES;
349 }
350
351 TdiBuildConnect(*Irp,
352 DeviceObject,
353 ConnectionObject,
354 CompletionRoutine,
355 CompletionContext,
356 NULL,
357 ConnectionCallInfo,
358 ConnectionReturnInfo);
359
360 return TdiCall(*Irp, DeviceObject, NULL, NULL);
361}
Irp
_In_ PIRP Irp
Definition: csq.h:116
NULL
#define NULL
Definition: types.h:112
TdiCall
static NTSTATUS TdiCall(PIRP Irp, PDEVICE_OBJECT DeviceObject, PKEVENT Event, PIO_STATUS_BLOCK Iosb)
Calls a transport driver device.
Definition: tdi.c:26
IoGetRelatedDeviceObject
PDEVICE_OBJECT NTAPI IoGetRelatedDeviceObject(IN PFILE_OBJECT FileObject)
Definition: device.c:1539
DPRINT
#define DPRINT
Definition: sndvol32.h:73
_DEVICE_OBJECT
Definition: env_spec_w32.h:413
TdiBuildInternalDeviceControlIrp
#define TdiBuildInternalDeviceControlIrp(IrpSubFunction, DeviceObject, FileObject, Event, IoStatusBlock)
Definition: tdikrnl.h:573
TDI_CONNECT
#define TDI_CONNECT
Definition: tdikrnl.h:49
TdiBuildConnect
#define TdiBuildConnect( Irp, DevObj, FileObj, CompRoutine, Contxt, Time, RequestConnectionInfo, ReturnConnectionInfo)
Definition: tdikrnl.h:494
STATUS_INVALID_PARAMETER
#define STATUS_INVALID_PARAMETER
Definition: udferr_usr.h:135
STATUS_INSUFFICIENT_RESOURCES
#define STATUS_INSUFFICIENT_RESOURCES
Definition: udferr_usr.h:158
DeviceObject
_In_ PDEVICE_OBJECT DeviceObject
Definition: wdfdevice.h:2061
CompletionContext
_In_ WDFREQUEST _In_opt_ PFN_WDF_REQUEST_COMPLETION_ROUTINE _In_opt_ __drv_aliasesMem WDFCONTEXT CompletionContext
Definition: wdfrequest.h:898
CompletionRoutine
_In_ WDFREQUEST _In_opt_ PFN_WDF_REQUEST_COMPLETION_ROUTINE CompletionRoutine
Definition: wdfrequest.h:895

Referenced by AfdStreamSocketConnect(), AfdStreamSocketSuperConnect(), and WskConnect().

◆ TdiDisconnect()

NTSTATUS TdiDisconnect ( PIRP *  Irp,
PFILE_OBJECT  TransportObject,
PLARGE_INTEGER  Time,
USHORT  Flags,
PIO_COMPLETION_ROUTINE  CompletionRoutine,
PVOID  CompletionContext,
PTDI_CONNECTION_INFORMATION  RequestConnectionInfo,
PTDI_CONNECTION_INFORMATION  ReturnConnectionInfo 
)

Definition at line 1260 of file tdi.c.

1268 {
1269 PDEVICE_OBJECT DeviceObject;
1270
1271 if (!TransportObject) {
1272 DPRINT("Bad transport object.\n");
1273 return STATUS_INVALID_PARAMETER;
1274 }
1275
1276 DPRINT("Called(TransportObject %p)\n", TransportObject);
1277
1278 DeviceObject = IoGetRelatedDeviceObject(TransportObject);
1279 if (!DeviceObject) {
1280 DPRINT("Bad device object.\n");
1281 return STATUS_INVALID_PARAMETER;
1282 }
1283
1284 *Irp = TdiBuildInternalDeviceControlIrp(TDI_DISCONNECT,
1285 DeviceObject,
1286 TransportObject,
1287 NULL,
1288 NULL);
1289
1290 if (!*Irp) {
1291 DPRINT("Insufficient resources.\n");
1292 return STATUS_INSUFFICIENT_RESOURCES;
1293 }
1294
1295 TdiBuildDisconnect(*Irp,
1296 DeviceObject,
1297 TransportObject,
1298 CompletionRoutine,
1299 CompletionContext,
1300 Time,
1301 Flags,
1302 RequestConnectionInfo,
1303 ReturnConnectionInfo);
1304
1305 TdiCall(*Irp, DeviceObject, NULL, NULL);
1306
1307 return STATUS_PENDING;
1308}
Time
static PLARGE_INTEGER Time
Definition: time.c:105
TdiBuildDisconnect
#define TdiBuildDisconnect( Irp, DevObj, FileObj, CompRoutine, Contxt, Time, Flags, RequestConnectionInfo, ReturnConnectionInfo)
Definition: tdikrnl.h:545
TDI_DISCONNECT
#define TDI_DISCONNECT
Definition: tdikrnl.h:52
STATUS_PENDING
#define STATUS_PENDING
Definition: telnetd.h:14
Flags
_Must_inspect_result_ _In_ ULONG Flags
Definition: wsk.h:170

Referenced by DoDisconnect().

◆ TdiOpenConnectionEndpointFile()

NTSTATUS TdiOpenConnectionEndpointFile ( PUNICODE_STRING  DeviceName,
PHANDLE  ConnectionHandle,
PFILE_OBJECT *  ConnectionObject 
)

Opens a connection endpoint file object.

Parameters
DeviceName= Pointer to counted string with name of device
ConnectionHandle= Address of buffer to place connection endpoint file handle
ConnectionObject= Address of buffer to place connection endpoint file object
Returns
Status of operation

Definition at line 258 of file tdi.c.

271{
272 PFILE_FULL_EA_INFORMATION EaInfo;
273 PVOID *ContextArea;
274 NTSTATUS Status;
275 ULONG EaLength;
276
277 DPRINT("Called. DeviceName (%wZ)\n", DeviceName);
278
279 /* EaName must be 0-terminated, even though TDI_TRANSPORT_ADDRESS_LENGTH does *not* include the 0 */
280 EaLength = sizeof(FILE_FULL_EA_INFORMATION) +
281 TDI_CONNECTION_CONTEXT_LENGTH +
282 sizeof(PVOID) + 1;
283
284 EaInfo = (PFILE_FULL_EA_INFORMATION)ExAllocatePoolWithTag(NonPagedPool,
285 EaLength,
286 TAG_AFD_EA_INFO);
287 if (!EaInfo)
288 return STATUS_INSUFFICIENT_RESOURCES;
289
290 RtlZeroMemory(EaInfo, EaLength);
291 EaInfo->EaNameLength = TDI_CONNECTION_CONTEXT_LENGTH;
292 /* Don't copy the terminating 0; we have already zeroed it */
293 RtlCopyMemory(EaInfo->EaName,
294 TdiConnectionContext,
295 TDI_CONNECTION_CONTEXT_LENGTH);
296 EaInfo->EaValueLength = sizeof(PVOID);
297 ContextArea = (PVOID*)(EaInfo->EaName + TDI_CONNECTION_CONTEXT_LENGTH + 1); /* 0-terminated */
298 /* FIXME: Allocate context area */
299 *ContextArea = NULL;
300 Status = TdiOpenDevice(DeviceName,
301 EaLength,
302 EaInfo,
303 AFD_SHARE_UNIQUE,
304 ConnectionHandle,
305 ConnectionObject);
306 ExFreePoolWithTag(EaInfo, TAG_AFD_EA_INFO);
307 return Status;
308}
TAG_AFD_EA_INFO
#define TAG_AFD_EA_INFO
Definition: afd.h:51
NTSTATUS
LONG NTSTATUS
Definition: precomp.h:26
TdiOpenDevice
static NTSTATUS TdiOpenDevice(PUNICODE_STRING DeviceName, ULONG EaLength, PFILE_FULL_EA_INFORMATION EaInfo, ULONG ShareType, PHANDLE Handle, PFILE_OBJECT *Object)
Opens a device.
Definition: tdi.c:68
ExAllocatePoolWithTag
#define ExAllocatePoolWithTag(hernya, size, tag)
Definition: env_spec_w32.h:350
NonPagedPool
#define NonPagedPool
Definition: env_spec_w32.h:307
EaLength
IN PVCB IN PDIRENT OUT PULONG EaLength
Definition: fatprocs.h:879
PFILE_FULL_EA_INFORMATION
struct _FILE_FULL_EA_INFORMATION * PFILE_FULL_EA_INFORMATION
FILE_FULL_EA_INFORMATION
struct _FILE_FULL_EA_INFORMATION FILE_FULL_EA_INFORMATION
Status
Status
Definition: gdiplustypes.h:25
ConnectionHandle
_In_ PKSPIN_CONNECT _In_ ACCESS_MASK _Out_ PHANDLE ConnectionHandle
Definition: ks.h:4538
ExFreePoolWithTag
#define ExFreePoolWithTag(_P, _T)
Definition: module.h:1109
AFD_SHARE_UNIQUE
#define AFD_SHARE_UNIQUE
Definition: netio.c:67
_FILE_FULL_EA_INFORMATION
Definition: from_kernel.h:193
_FILE_FULL_EA_INFORMATION::EaValueLength
USHORT EaValueLength
Definition: from_kernel.h:197
_FILE_FULL_EA_INFORMATION::EaNameLength
UCHAR EaNameLength
Definition: from_kernel.h:196
_FILE_FULL_EA_INFORMATION::EaName
CHAR EaName[1]
Definition: from_kernel.h:198
TDI_CONNECTION_CONTEXT_LENGTH
#define TDI_CONNECTION_CONTEXT_LENGTH
Definition: tdi.h:373
TdiConnectionContext
#define TdiConnectionContext
Definition: tdi.h:371
PVOID
void * PVOID
Definition: typedefs.h:50
RtlCopyMemory
#define RtlCopyMemory(Destination, Source, Length)
Definition: typedefs.h:263
RtlZeroMemory
#define RtlZeroMemory(Destination, Length)
Definition: typedefs.h:262
ULONG
uint32_t ULONG
Definition: typedefs.h:59
DeviceName
_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_opt_ PCUNICODE_STRING DeviceName
Definition: wdfdevice.h:3281

Referenced by WarmSocketForConnection(), and WskSocket().

◆ TdiQueryDeviceControl()

NTSTATUS TdiQueryDeviceControl ( PFILE_OBJECT  FileObject,
ULONG  IoControlCode,
PVOID  InputBuffer,
ULONG  InputBufferLength,
PVOID  OutputBuffer,
ULONG  OutputBufferLength,
PULONG  Return 
)

Queries a device for information.

Parameters
FileObject= Pointer to file object
IoControlCode= I/O control code
InputBuffer= Pointer to buffer with input data
InputBufferLength= Length of InputBuffer
OutputBuffer= Address of buffer to place output data
OutputBufferLength= Length of OutputBuffer
Returns
Status of operation

Definition at line 630 of file tdi.c.

650{
651 PDEVICE_OBJECT DeviceObject;
652 IO_STATUS_BLOCK Iosb;
653 NTSTATUS Status;
654 KEVENT Event;
655 PIRP Irp;
656
657 if (!FileObject) {
658 DPRINT("Bad file object.\n");
659 return STATUS_INVALID_PARAMETER;
660 }
661
662 DeviceObject = IoGetRelatedDeviceObject(FileObject);
663 if (!DeviceObject) {
664 DPRINT("Bad device object.\n");
665 return STATUS_INVALID_PARAMETER;
666 }
667
668 KeInitializeEvent(&Event, NotificationEvent, FALSE);
669
670 Irp = IoBuildDeviceIoControlRequest(IoControlCode,
671 DeviceObject,
672 InputBuffer,
673 InputBufferLength,
674 OutputBuffer,
675 OutputBufferLength,
676 FALSE,
677 &Event,
678 &Iosb);
679 if (!Irp)
680 return STATUS_INSUFFICIENT_RESOURCES;
681
682 Status = TdiCall(Irp, DeviceObject, &Event, &Iosb);
683
684 if (Return)
685 *Return = Iosb.Information;
686
687 return Status;
688}
FALSE
#define FALSE
Definition: types.h:117
Iosb
return Iosb
Definition: create.c:4403
KeInitializeEvent
#define KeInitializeEvent(pEvt, foo, foo2)
Definition: env_spec_w32.h:477
NotificationEvent
@ NotificationEvent
Definition: ntdef.template.h:365
IoBuildDeviceIoControlRequest
PIRP NTAPI IoBuildDeviceIoControlRequest(IN ULONG IoControlCode, IN PDEVICE_OBJECT DeviceObject, IN PVOID InputBuffer, IN ULONG InputBufferLength, IN PVOID OutputBuffer, IN ULONG OutputBufferLength, IN BOOLEAN InternalDeviceIoControl, IN PKEVENT Event, IN PIO_STATUS_BLOCK IoStatusBlock)
Definition: irp.c:881
_IO_STATUS_BLOCK
Definition: env_spec_w32.h:870
_IRP
Definition: Bus_PDO_EvalMethod.c:107
_KEVENT
Definition: ketypes.h:863
IoControlCode
_In_ WDFREQUEST _In_ size_t _In_ size_t _In_ ULONG IoControlCode
Definition: wdfio.h:325
OutputBufferLength
_In_ WDFREQUEST _In_ size_t OutputBufferLength
Definition: wdfio.h:320
InputBufferLength
_In_ WDFREQUEST _In_ size_t _In_ size_t InputBufferLength
Definition: wdfio.h:322
OutputBuffer
_Must_inspect_result_ _In_ WDFIOTARGET _In_opt_ WDFREQUEST _In_opt_ PWDF_MEMORY_DESCRIPTOR OutputBuffer
Definition: wdfiotarget.h:863
InputBuffer
_Must_inspect_result_ _In_ WDFIOTARGET _In_opt_ WDFREQUEST _In_opt_ PWDF_MEMORY_DESCRIPTOR InputBuffer
Definition: wdfiotarget.h:953

Referenced by TdiQueryInformationEx().

◆ TdiQueryInformation()

NTSTATUS TdiQueryInformation ( PFILE_OBJECT  FileObject,
LONG  QueryType,
PMDL  MdlBuffer 
)

Query for information.

Parameters
FileObject= Pointer to file object
QueryType= Query type
MdlBuffer= Pointer to MDL buffer specific for query type
Returns
Status of operation

Definition at line 691 of file tdi.c.

704{
705 PDEVICE_OBJECT DeviceObject;
706 IO_STATUS_BLOCK Iosb;
707 KEVENT Event;
708 PIRP Irp;
709
710 if (!FileObject) {
711 DPRINT("Bad file object.\n");
712 return STATUS_INVALID_PARAMETER;
713 }
714
715 DeviceObject = IoGetRelatedDeviceObject(FileObject);
716 if (!DeviceObject) {
717 DPRINT("Bad device object.\n");
718 return STATUS_INVALID_PARAMETER;
719 }
720
721 KeInitializeEvent(&Event, NotificationEvent, FALSE);
722
723 Irp = TdiBuildInternalDeviceControlIrp(TDI_QUERY_INFORMATION,
724 DeviceObject,
725 ConnectionObject,
726 &Event,
727 &Iosb);
728 if (!Irp) {
729 return STATUS_INSUFFICIENT_RESOURCES;
730 }
731
732 TdiBuildQueryInformation(Irp,
733 DeviceObject,
734 FileObject,
735 NULL,
736 NULL,
737 QueryType,
738 MdlBuffer);
739
740 return TdiCall(Irp, DeviceObject, &Event, &Iosb);
741}
QueryType
_Must_inspect_result_ _In_ KTMOBJECT_TYPE QueryType
Definition: nttmapi.h:404
TDI_QUERY_INFORMATION
#define TDI_QUERY_INFORMATION
Definition: tdikrnl.h:58
TdiBuildQueryInformation
#define TdiBuildQueryInformation( Irp, DevObj, FileObj, CompRoutine, Contxt, QType, MdlAddr)
Definition: tdikrnl.h:638

Referenced by AfdGetSockName(), and TdiQueryMaxDatagramLength().

◆ TdiSetEventHandler()

NTSTATUS TdiSetEventHandler ( PFILE_OBJECT  FileObject,
LONG  EventType,
PVOID  Handler,
PVOID  Context 
)

Sets or resets an event handler.

Parameters
FileObject= Pointer to file object
EventType= Event code
Handler= Event handler to be called when the event occurs
Context= Context input to handler when the event occurs
Returns
Status of operation

Specify NULL for Handler to stop calling event handler

Definition at line 569 of file tdi.c.

586{
587 PDEVICE_OBJECT DeviceObject;
588 IO_STATUS_BLOCK Iosb;
589 KEVENT Event;
590 PIRP Irp;
591
592 DPRINT("Called\n");
593
594 if (!FileObject) {
595 DPRINT("Bad file object.\n");
596 return STATUS_INVALID_PARAMETER;
597 }
598
599 DeviceObject = IoGetRelatedDeviceObject(FileObject);
600 if (!DeviceObject) {
601 DPRINT("Bad device object.\n");
602 return STATUS_INVALID_PARAMETER;
603 }
604
605 KeInitializeEvent(&Event, NotificationEvent, FALSE);
606
607 Irp = TdiBuildInternalDeviceControlIrp(TDI_SET_EVENT_HANDLER,
608 DeviceObject,
609 FileObject,
610 &Event,
611 &Iosb);
612 if (!Irp)
613 return STATUS_INSUFFICIENT_RESOURCES;
614
615
616
617 TdiBuildSetEventHandler(Irp,
618 DeviceObject,
619 FileObject,
620 NULL,
621 NULL,
622 EventType,
623 Handler,
624 Context);
625
626 return TdiCall(Irp, DeviceObject, &Event, &Iosb);
627}
Handler
ACPI_PHYSICAL_ADDRESS ACPI_SIZE BOOLEAN Warn UINT32 *TableIdx UINT32 ACPI_TABLE_HEADER *OutTableHeader ACPI_TABLE_HEADER **OutTable ACPI_HANDLE UINT32 ACPI_WALK_CALLBACK ACPI_WALK_CALLBACK void void **ReturnValue UINT32 ACPI_BUFFER *RetPathPtr ACPI_OBJECT_HANDLER Handler
Definition: acpixf.h:672
EventType
_In_ ACCESS_MASK _In_opt_ POBJECT_ATTRIBUTES _In_ EVENT_TYPE EventType
Definition: exfuncs.h:167
TdiBuildSetEventHandler
#define TdiBuildSetEventHandler( Irp, DevObj, FileObj, CompRoutine, Contxt, InEventType, InEventHandler, InEventContext)
Definition: tdikrnl.h:791
TDI_SET_EVENT_HANDLER
#define TDI_SET_EVENT_HANDLER
Definition: tdikrnl.h:57

Referenced by AfdDeregisterEventHandlers(), and AfdRegisterEventHandlers().