VOID
TdiBuildAssociateAddress (
IN PIRP Irp,
IN PDEVICE_OBJECT DeviceObject,
IN PFILE_OBJECT FileObject,
IN PVOID CompletionRoutine,
IN PVOID Context,
IN HANDLE AddressHandle
);
TdiBuildAssociateAddress builds an IRP containing a TDI_ASSOCIATE_ADDRESS 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 TdiBuildAssociateAddress places the parameter list. IRP members related to the associate address request are:
| IRP Component | Meaning |
| IoStatus.Status | Specifies the final status of the associate address request. |
| IrpSp->MajorFunction | Specifies IRP_MJ_INTERNAL_DEVICE_CONTROL. |
| IrpSp->MinorFunction | Specifies TDI_ASSOCIATE_ADDRESS. |
| IrpSp->FileObject | Points to a file object representing the connection endpoint associated with the address object. |
| IrpSp->Parameters | Points to a TDI_REQUEST_KERNEL_ASSOCIATE structure that defines the 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.
AddressHandle
Specifies a handle of an address object (see TDI_REQUEST_KERNEL_ASSOCIATE).
See Also