Funzione AtaPortRegistryChannelSubkeyRead (irb.h)

Articolo
02/07/2025

La routine AtaPortRegistryChannelSubKeyRead legge i dati associati al nome di valore indicato sotto la chiave del Registro di sistema HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelM, dove N è il numero del controller e M è il numero del canale.

Nota I modelli di driver di porta ATA e miniport ATA potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare driver Storport e modelli di driver miniport Storport.

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. A 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 non riesce, 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.

Osservazioni

Il buffer a cui punta 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 StartChannel o StopChannel nel parametro ControlAction .