Edit

Share via

AtaPortReleaseRequestSenseIrb function (irb.h)

  • Article

The AtaPortReleaseRequestSenseIrb routine frees the request sense IRB that is allocated by using AtaPortBuildRequestSenseIrb.

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

void AtaPortReleaseRequestSenseIrb(
  [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 request sense IRB.

Return value

None

Remarks

The AtaPortReleaseRequestSenseIrb routine releases the IRB to the port driver and copies the sense data to the buffer that is pointed to by the SenseInfoBuffer member of the original (failed) request's IRB. The miniport driver can then complete the original request by using AtaPortCompleteRequest. The miniport driver must not touch the request sense IRB after it has been released to the port driver.

The miniport driver must call AtaPortReleaseRequestSenseIrb for every allocated IRB that is allocated by using AtaPortBuildRequestSenseIrb.

Requirements

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

See also

AtaPortBuildRequestSenseIrb

AtaPortCompleteRequest