IDE_HW_INITIALIZE funzione di callback (irb.h)

Articolo
02/07/2025

La routine del driver IdeHwInitialize miniport configura il dispositivo indicato.

Nota I modelli di driver di porta ATA e miniport ATA potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare driver Storport e modelli di driver miniport Storport.

Sintassi

IDE_HW_INITIALIZE IdeHwInitialize;

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

Parametri

[in] ChannelExtension

Puntatore al driver miniport per ogni estensione del dispositivo del canale.

[in, out] DeviceParameters

Puntatore a una struttura di tipo IDE_DEVICE_PARAMETERS che identifica il dispositivo da configurare e i parametri del dispositivo con cui configurare il dispositivo.

[in] IdentifyData

Puntatore a una struttura di tipo IDENTIFY_DEVICE_DATA che contiene i dati di identificazione restituiti dal dispositivo.

Valore restituito

IdeHwInitialize restituisce TRUE se l'operazione ha esito positivo. Restituisce FALSE se l'operazione non riesce.

Osservazioni

Dopo che il driver miniport enumera i dispositivi in un canale, chiama il IdeHwInitialize routine una volta per ogni dispositivo che enumera. La routine IdeHwInitialize deve configurare ogni dispositivo in base alle informazioni specificate nella struttura IDE_DEVICE_PARAMETERS, a cui punta il parametro deviceParameters. In casi eccezionali, il driver miniport può configurare il dispositivo usando un set di parametri che differiscono da quelli contenuti in IDE_DEVICE_PARAMETERS. In questi casi, il driver miniport deve aggiornare le informazioni in IDE_DEVICE_PARAMETERS in modo da contenere il valore del parametro effettivamente usato per configurare il dispositivo. Al termine della routine IdeHwInitialize, il driver della porta aggiorna le informazioni memorizzate nella cache con i valori dei parametri forniti dal driver miniport.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	irb.h (include Irb.h)

Vedere anche

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS

Condividi tramite