Edit

Share via

AtaPortGetScatterGatherList function (irb.h)

  • Article

The AtaPortGetScatterGatherList routine retrieves the scatter/gather list that is associated with this request.

Note  The ATA port driver and ATA miniport driver models may be altered or unavailable in the future. Instead, we recommend using the Storport driver and Storport miniport driver models.
 

Syntax

PIDE_SCATTER_GATHER_LIST AtaPortGetScatterGatherList(
  [in] PVOID              ChannelExtension,
  [in] PIDE_REQUEST_BLOCK Irb
);

Parameters

[in] ChannelExtension

A pointer to the channel extension.

[in] Irb

A pointer to a structure of type IDE_REQUEST_BLOCK that defines the IDE request block (IRB) for which a scatter/gather list is constructed.

Return value

If the IRB_FLAGS_USE_DMA flag is set in the IrbFlags member of IRB, the AtaPortGetScatterGatherList routine returns a pointer to the scatter/gather list that is associated with the IRB. Otherwise, AtaPortGetScatterGatherList returns NULL.

Remarks

Every IRB with IRB_FLAGS_USE_DMA set in the IrbFlags member has a scatter/gather list associated with it.

The miniport driver must not modify the scatter/gather list.

Requirements

Requirement Value
Target Platform Desktop
Header irb.h (include Ata.h, Irb.h)
Library Ataport.lib; Pciidex.lib

See also

IDE_REQUEST_BLOCK