TdiBuildAction

VOID
TdiBuildAction (
IN PIRP Irp,
IN PDEVICE_OBJECT DeviceObject,
IN PFILE_OBJECT FileObject,
IN PVOID CompletionRoutine,
IN PVOID Context,
IN PMDL MdlAddress
);

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

IRP Component Meaning
IoStatus.Status Specifies the final status of the action request.
IoStatus.Information Contains the number of data bytes the internal driver action function writes.
IrpSp->MajorFunction Specifies IRP_MJ_INTERNAL_DEVICE_CONTROL.
IrpSp->MinorFunction Specifies TDI_ACTION.
IrpSp->FileObject Points to an address, connection endpoint, or control channel file object.
MdlAddress Points to a chain of MDLs describing the action parameter block.
IrpSp->Parameters Unused.

DeviceObject

Points to the device object that describes the TDI driver.

FileObject

Points to an address, connection endpoint, or control channel 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.

MdlAddress

Points to the MDL chain describing the action parameter block.

See Also

TDI_ACTION