TdiBuildAccept

VOID
TdiBuildAccept (
IN PIRP Irp,
IN PDEVICE_OBJECT DeviceObject,
IN PFILE_OBJECT FileObject,
IN PVOID CompletionRoutine,
IN PVOID Context,
IN PTDI_CONNECTION_INFORMATION RequestConnectionInformation,
OUT PTDI_CONNECTION_INFORMATION ReturnConnectionInformation
);

TdiBuildAccept builds an IRP containing a TDI_ACCEPT 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 TdiBuildAccept places the parameter list. IRP members related to the accept request are:

IRP Component Meaning
IoStatus.Status Specifies the final status of the accept request.
IrpSp->MajorFunction Specifies IRP_MJ_INTERNAL_DEVICE_CONTROL.
IrpSp->MinorFunction Specifies TDI_ACCEPT.
IrpSp->FileObject Points to a file object representing the connection endpoint at which a listen request has completed.
IrpSp->Parameters Specifies a TDI_REQUEST_KERNEL_ACCEPT structure that defines the kernel-mode client request.

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.

RequestConnectionInformation

Points to a TDI_CONNECTION_INFORMATION structure that defines the valid remote node client address from which the local node client can accept a connection.

ReturnConnectionInformation

Points to the caller–defined memory location to which TdiBuildAccept writes a TDI_CONNECTION_INFORMATION structure providing the remote node client address to which the local node client has connected. If the local node client requires no output information or if the TDI driver does not accommodate such information, this parameter is NULL.

See Also

TDI_ACCEPT, TDI_CONNECTION_INFORMATION, TDI_REQUEST_KERNEL_ACCEPT