Funzione AtaPortRegistryChannelSubkeyRead (irb.h)
La routine AtaPortRegistryChannelSubKeyRead legge i dati associati al nome del valore indicato nella chiave HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelMdel Registro di sistema , dove N è il numero del controller e M è il numero del canale.
Sintassi
BOOLEAN AtaPortRegistryChannelSubkeyRead(
[in] PVOID ChannelExtension,
[in] UCHAR ControllerNumber,
[in] PCHAR ValueName,
[in] UCHAR ValueType,
[out, optional] PUCHAR Buffer,
PULONG BufferLength
);
Parametri
[in] ChannelExtension
Puntatore all'estensione del canale.
[in] ControllerNumber
Contiene il numero del controller.
[in] ValueName
Contiene il nome del valore del Registro di sistema da cui leggere.
[in] ValueType
Indica il tipo di dati contenuti nel valore del Registro di sistema. Questo membro deve essere assegnato uno dei valori indicati nella tabella seguente.
| Valore | Significato |
|---|---|
| IDE_REG_DWORD | Valore numerico a 4 byte. |
| IDE_REG_BINARY | Dati binari. |
| IDE_REG_SZ | Terminazione null. Stringa Unicode. |
[out, optional] Buffer
Puntatore al buffer di destinazione in cui verranno scritti i dati letti dal Registro di sistema.
BufferLength
Puntatore al numero di byte di dati da copiare. Se l'operazione ha esito negativo, il percorso a cui punta lunghezza verrà aggiornato alla lunghezza dei dati copiati correttamente dal Registro di sistema.
Valore restituito
AtaPortRegistryChannelSubKeyRead restituisce TRUE se l'operazione ha esito positivo. In caso contrario, restituisce FALSE. La routine restituisce anche FALSE se il driver miniport non lo chiama dalla routine corretta.
Commenti
Il buffer a cui punta il buffer deve essere allocato usando AtaPortRegistryAllocateBuffer.
Il driver miniport deve chiamare AtaPortRegistryChannelSubKeyRead durante la routine AtaChannelInitRoutine o la routine IdeHwControl oppure restituirà FALSE. Inoltre, il driver miniport può chiamare solo AtaPortRegistryChannelSubKeyRead dalla routine IdeHwControl se la routine IdeHwControl è stata chiamata e ha un valore di StartChannel o StopChannel nel parametro ControlAction.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | irb.h (include Ata.h, Irb.h) |