VOID
TdiBuildDisconnect (
IN PIRP Irp,
IN PDEVICE_OBJECT DeviceObject,
IN PFILE_OBJECT FileObject,
IN PVOID CompletionRoutine,
IN PVOID Context,
IN PTIME Time
);
TdiBuildDisconnect builds an IRP containing a TDI_DISCONNECT request message. It sets up the request message in the minor function code member of the I/O stack location and sets IRP_MJ_INTERNAL_DEVICE_CONTROL as a major function code.
Parameters
Irp
Points to the I/O stack location for the kernel-mode client IRP. The current stack location must point to the location in which TdiBuildDisconnect places the parameter list. IRP members related to the disconnect request are:
| IRP Component | Meaning |
| IoStatus.Status | Specifies the final status of the disconnect request. |
| IrpSp->MajorFunction | Specifies IRP_MJ_INTERNAL_DEVICE_CONTROL. |
| IrpSp->MinorFunction | Specifies TDI_DISCONNECT. |
| IrpSp->FileObject | Points to a connection endpoint file object. |
| IrpSp->Parameters | Points to a TDI_REQUEST_KERNEL structure containing a pointer to the TDI driver-specific disconnect flags. |
| IrpSp->Parameters.RequestSpecific | Points to a LARGE_INTEGER structure containing the time–out value for the driver disconnect function. If this field is NULL, the TDI driver must choose an appropriate time–out. |
DeviceObject
Points to the device object that describes the TDI driver.
FileObject
Points to a connection endpoint file object.
CompletionRoutine
Points to the client completion function the I/O subsystem can call when I/O is complete. This parameter must be NULL if the I/O subsystem calls no completion function.
Context
Points to the context the client associates with its completion function.
Time
Points to the time–out value for the internal TDI driver disconnect function.
See Also