AtaPortGetScatterGatherList function (irb.h)

Article
02/22/2024

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