AtaPortRegistryChannelSubkeyRead, fonction (irb.h)

Article
02/07/2025

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

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 AtaPortRegistryChannelSubkeyRead(
  [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 à partir de laquelle lire.

[in] ValueType

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

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

[out, optional] Buffer

Pointeur vers la mémoire tampon de destination où les données lues à partir du Registre seront écrites.

BufferLength

Pointeur vers le nombre d’octets de données à copier. Si l’opération échoue, l’emplacement vers lequel pointe Length met à jour la longueur des données qui ont été correctement copiées à partir du Registre.

Valeur de retour

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

Remarques

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

Le pilote miniport doit appeler AtaPortRegistryChannelSubKeyRead pendant la routine AtaChannelInitRoutine ou la routine IdeHwControl ou retournera FALSE. En outre, le pilote miniport peut uniquement appeler AtaPortRegistryChannelSubKeyRead à partir de sa routine d'IdeHwControl si sa routine IdeHwControl a été appelée et avait une valeur de StartChannel ou StopChannel dans son paramètre ControlAction .