IDE_HW_INITIALIZE fonction de rappel (irb.h)

Article
02/07/2025

L'IdeHwInitialize routine de pilote miniport configure l’appareil indiqué.

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

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 de retour

IdeHwInitialize retourne TRUE si l’opération réussit. Elle retourne FAUX en cas d’échec de l’opération.

Remarques

Une fois que le pilote miniport énumère les appareils sur un canal, il appelle l'IdeHwInitialize routine 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 de IDE_DEVICE_PARAMETERS pour contenir la valeur du paramètre qu’il a réellement utilisée pour configurer l’appareil. Une fois que l'IdeHwInitialize routine retourne, le pilote de port met à jour ses informations mises en cache avec les valeurs de paramètre fournies par le pilote miniport.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	irb.h (include Irb.h)

Voir aussi

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS

Partager via