IDE_HW_INITIALIZE funzione di callback (irb.h)

Articolo
02/26/2024

La routine driver miniport IdeHwInitialize 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 il driver Storport e i 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.

Commenti

Dopo che il driver miniport enumera i dispositivi in un canale, chiama la routine IdeHwInitialize 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 per 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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	irb.h (include Irb.h)

Vedi anche

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS

Condividi tramite