AtaPortRegistryControllerKeyRead, fonction (irb.h)

Article
02/07/2025

La routine AtaPortRegistryControllerKeyRead lit les données associées au nom de valeur indiqué sous la clé de Registre HKLM\CurrentControlSet\Services\<service name>\ControllerN, où N correspond au nombre du contrôleur.

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

BOOLEAN AtaPortRegistryControllerKeyRead(
  [in]            PVOID  ChannelExtension,
  [in]            UCHAR  ControllerNumber,
  [in]            PCHAR  ValueName,
  [in]            UCHAR  ValueType,
  [out, optional] PUCHAR Buffer,
                  PULONG BufferLength
);

Paramètres

[in] ChannelExtension

Pointeur vers l’extension de canal.

[in] ControllerNumber

Contient le numéro du contrôleur.

[in] ValueName

Contient le nom de la valeur de Registre à lire.

[in] ValueType

Indique le type des données contenues dans la valeur de Registre. Ce paramètre doit être affecté à l’une des valeurs indiquées dans le tableau suivant.

Type valeur	Signification
IDE_REG_DWORD	Valeur numérique de 4 octets.
IDE_REG_BINARY	Données binaires.
IDE_REG_SZ	Chaîne Unicode terminée par null.

[out, optional] Buffer

Pointeur vers la mémoire tampon où les résultats doivent être copiés.

BufferLength

Pointeur vers le nombre d’octets de données à copier. Si l’opération échoue en raison d’une mémoire tampon insuffisante, l’emplacement pointé par Longueur sera mis à jour jusqu’à la longueur réelle des données dans le Registre.

Valeur de retour

AtaPortRegistryControllerKeyRead retourne TRUE si l’opération réussit. Sinon, elle retourne FALSE. La routine AtaPortRegistryControllerKeyRead retourne également FAUX si le pilote miniport ne l’appelle pas à partir de la routine correcte.

Remarques

La mémoire tampon à tampon doit être allouée à l’aide de AtaPortRegistryAllocateBuffer.

Le pilote miniport doit appeler AtaPortRegistryControllerKeyRead dans sa routine AtaChannelInitRoutine ou dans sa routine IdeHwControl. Il ne peut pas appeler AtaPortRegistryControllerKeyRead à partir d’une autre routine. En outre, le pilote miniport peut appeler uniquement AtaPortRegistryControllerKeyRead à partir de sa routine IdeHwControl si sa routine IdeHwControl a été appelée et avait une valeur de StartChannel ou StopChannel dans son paramètre ControlAction .

Exigences

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

Voir aussi

AtaChannelInitRoutine

AtaPortRegistryAllocateBuffer

IdeHwControl

Partager via