Edit

AtaPortRequestWorkerRoutine function (irb.h)

  • Article

The AtaPortRequestWorkerRoutine routine requests a worker routine.

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

BOOLEAN AtaPortRequestWorkerRoutine(
  [in] PVOID      ChannelExtension,
       IDE_HW_DPC CallBackRoutine
);

Parameters

[in] ChannelExtension

A pointer to the channel extension.

CallBackRoutine

A pointer of type IDE_HW_DPC to the worker routine to call.

Return value

None

Remarks

The miniport driver can request a worker routine to perform tasks that cannot be done in the interrupt service routine. Transferring operations to a worker routine is an effective way to keep the interrupt service routine as small as possible.

The worker routine is not synchronized with the interrupt.

When the port driver calls the worker routine, the port driver will pass the pointer to the channel extension that is stored in ChannelExtension.

The WorkerRoutine function pointer is declared in Irb.h as follows:

typedef
VOID
(*IDE_HW_DPC) (
  IN PVOID ChannelExtension
  );

Requirements

Requirement Value
Target Platform Desktop
Header irb.h (include Ata.h, Irb.h)