IDE_HW_INITIALIZE fonction de rappel (irb.h)

Article
02/26/2024

La routine du pilote miniport IdeHwInitialize configure l’appareil indiqué.

Note Les modèles de pilote de port ATA et de pilote miniport ATA peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser les modèles de pilote Storport et de pilote miniport Storport .

Syntaxe

IDE_HW_INITIALIZE IdeHwInitialize;

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

Paramètres

[in] ChannelExtension

Pointeur vers le pilote miniport par extension de périphérique de canal.

[in, out] DeviceParameters

Pointeur vers une structure de type IDE_DEVICE_PARAMETERS qui identifie l’appareil à configurer et les paramètres de l’appareil avec lesquels configurer l’appareil.

[in] IdentifyData

Pointeur vers une structure de type IDENTIFY_DEVICE_DATA qui contient les données d’identification retournées par l’appareil.

Valeur retournée

IdeHwInitialize retourne TRUE si l’opération réussit. Elle retourne FALSE si l’opération échoue.

Remarques

Une fois que le pilote miniport énumère les appareils sur un canal, il appelle la routine IdeHwInitialize une fois pour chaque appareil qu’il énumère. La routine IdeHwInitialize doit configurer chaque appareil en fonction des informations spécifiées dans la structure IDE_DEVICE_PARAMETERS , pointée par le paramètre DeviceParameters . Dans des cas exceptionnels, le pilote miniport peut configurer l’appareil à l’aide d’un ensemble de paramètres qui diffèrent de ceux contenus dans IDE_DEVICE_PARAMETERS. Dans ce cas, le pilote miniport doit mettre à jour les informations dans IDE_DEVICE_PARAMETERS pour contenir la valeur de paramètre qu’il a réellement utilisée pour configurer l’appareil. Une fois la routine IdeHwInitialize retournée, le pilote de port met à jour ses informations mises en cache avec les valeurs de paramètre fournies par le pilote miniport.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	irb.h (include Irb.h)

Voir aussi

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS

Partager via