AtaPortRequestSynchronizedRoutine function (irb.h)

Article
02/22/2024

The AtaPortRequestSynchronizedRoutine routine is used by the miniport driver to request synchronization with the interrupt service routine (ISR).

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 AtaPortRequestSynchronizedRoutine(
  [in] PVOID      ChannelExtension,
       IDE_HW_DPC CallBackRoutine
);

Parameters

[in] ChannelExtension

A pointer to the channel extension.

CallBackRoutine

A pointer to the routine to call.

Return value

None

Remarks

This routine is typically used by miniport drivers that set the SyncWithIsr member of the IDE_CHANNEL_CONFIGURATION structure to FALSE. When SyncWithIsr is set to FALSE, the miniport driver should use the AtaPortRequestSynchronizedRoutine routine to ensure synchronized access to data structures that are modified in the ISR.

The pointer to the channel extension that is stored in ChannelExtension will be passed to the worker routine when it is called.

When the port driver calls the routine that is pointed to by SynchronizedRoutine, it passes the pointer to the channel extension that is stored in ChannelExtension.

The SynchronizedRoutine 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)