Instance Property

SetDCLRanges

Set the scatter gather list for a NuDCL

Declaration

IOReturn (*SetDCLRanges)(NuDCLRef dcl, UInt32 numRanges, IOVirtualRange *ranges);

Parameters

dcl

The DCL to modify

numRanges

number of ranges in 'ranges'.

ranges

An array of virtual ranges

Return Value

Returns an IOReturn error code.

Discussion

Set the list of data buffers for a DCL. Setting too many ranges may result in a memory region with too many discontinous physical segments for the hardware to send or receive in a single packet. This will result in an error when the program is compiled.

This change will apply immediately to a non-running DCL program. To apply the change to a running program use IOFireWireLocalIsochPortInterface::Notify()

Applies: NuDCLSendPacketRef, NuDCLReceivePacketRef

See Also

Miscellaneous

AllocateReceivePacket

Allocate a ReceivePacket NuDCL and append it to the program

AllocateReceivePacket_v

Allocate a ReceivePacket NuDCL and append it to the program

AllocateSendPacket

Allocate a SendPacket NuDCL and append it to the program.

AllocateSendPacket_v

Allocate a SendPacket NuDCL and append it to the program.

AllocateSkipCycle

Allocate a SkipCycle NuDCL and append it to the program.

AppendDCLRanges

Add a memory range to the scatter gather list of a NuDCL

CountDCLRanges

Returns number of buffers for a NuDCL

FindDCLNextDCL

Get the next pointer for a NuDCL

GetDCLBranch

Get the branch pointer for a NuDCL

GetDCLCallback

Get callback for a NuDCL

GetDCLRanges

Get the scatter-gather list for a NuDCL

GetDCLs

Returns the pool's DCL program as a CFArray of NuDCLRef's.

GetDCLSize

Returns number of bytes to be transferred by a NuDCL

GetDCLSpan

Returns a virtual range spanning lowest referenced buffer address to highest

GetDCLStatusPtr

Get the status pointer for a NuDCL.

GetDCLTimeStampPtr

Get the time stamp pointer for a NuDCL.

GetProgram

Finds the first DCL in the pool not preceeded by any other DCL.

SetCurrentTagAndSync

Set current tag and sync bits

SetDCLBranch

Set the branch pointer for a NuDCL

SetDCLCallback

Set the callback for a NuDCL

SetDCLStatusPtr

Set the status pointer for a NuDCL

SetDCLTimeStampPtr

Set the time stamp pointer for a NuDCL

SetDCLUserHeaderPtr

Set a user specified header for a send NuDCL