Função AtaPortRequestSynchronizedRoutine (irb.h)

Artigo
02/07/2025

A rotina AtaPortRequestSynchronizedRoutine é usada pelo driver de miniporto para solicitar a sincronização com a ISR (rotina de serviço de interrupção).

Observação o driver de porta do ATA e os modelos de driver de miniporto do ATA podem estar alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar o de driver do Storport e miniporto storport modelos de driver.

Sintaxe

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

Parâmetros

[in] ChannelExtension

Um ponteiro para a extensão do canal.

CallBackRoutine

Um ponteiro para a rotina a ser chamada.

Valor de retorno

Nenhum

Observações

Essa rotina normalmente é usada por drivers de miniporto que definem o membro SyncWithIsr da estrutura IDE_CHANNEL_CONFIGURATION para FALSE. Quando SyncWithIsr é definido como FALSE, o driver de miniport deve usar a rotina AtaPortRequestSynchronizedRoutine para garantir o acesso sincronizado às estruturas de dados modificadas no ISR.

O ponteiro para a extensão de canal armazenada em ChannelExtension será passado para a rotina de trabalho quando ela for chamada.

Quando o driver de porta chama a rotina que é apontada por synchronizedRoutine, ele passa o ponteiro para a extensão de canal armazenada em ChannelExtension.

O ponteiro da função synchronizedRoutine é declarado em Irb.h da seguinte maneira:

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

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	irb.h (include Ata.h, Irb.h)

Consulte também

AtaPortControllerSyncRoutine

Partilhar via