IDE_HW_INITIALIZE função de retorno de chamada (irb.h)

Artigo
02/07/2025

O IdeHwInitialize rotina do driver de miniporto configura o dispositivo indicado.

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

IDE_HW_INITIALIZE IdeHwInitialize;

BOOLEAN IdeHwInitialize(
  [in]      PVOID ChannelExtension,
  [in, out] PIDE_DEVICE_PARAMETERS DeviceParameters,
  [in]      PIDENTIFY_DEVICE_DATA IdentifyData
)
{...}

Parâmetros

[in] ChannelExtension

Um ponteiro para o driver de miniporto por extensão de dispositivo de canal.

[in, out] DeviceParameters

Um ponteiro para uma estrutura do tipo IDE_DEVICE_PARAMETERS que identifica o dispositivo a ser configurado e os parâmetros do dispositivo com os quais configurar o dispositivo.

[in] IdentifyData

Um ponteiro para uma estrutura do tipo IDENTIFY_DEVICE_DATA que contém os dados de identificação retornados pelo dispositivo.

Valor de retorno

IdeHwInitialize retornará TRUE se a operação for bem-sucedida. Ele retornará FALSE se a operação falhar.

Observações

Depois que o driver de miniporto enumerar os dispositivos em um canal, ele chamará o IdeHwInitialize rotina uma vez para cada dispositivo enumerado. A rotina IdeHwInitialize deve configurar cada dispositivo com base nas informações especificadas na estrutura IDE_DEVICE_PARAMETERS, apontada pelo parâmetro DeviceParameters. Em casos excepcionais, o driver de miniporto pode configurar o dispositivo usando um conjunto de parâmetros que diferem daqueles contidos em IDE_DEVICE_PARAMETERS. Nesses casos, o driver de miniporto deve atualizar as informações em IDE_DEVICE_PARAMETERS para conter o valor do parâmetro que ele realmente usou para configurar o dispositivo. Depois que a rotina IdeHwInitialize retorna, o driver de porta atualiza suas informações armazenadas em cache com os valores de parâmetro fornecidos pelo driver de miniporto.

Requisitos

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

Consulte também

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS

Compartilhar via