Name

do_drive_get_GTF — get the drive bootup default taskfile settings

Synopsis

int do_drive_get_GTF (struct ata_port *  ap,
 int  ix,
 unsigned int *  gtf_length,
 unsigned long *  gtf_address,
 unsigned long *  obj_loc);

Arguments

ap

the ata_port for the drive

ix

target ata_device (drive) index

gtf_length

number of bytes of _GTF data returned at gtf_address

gtf_address

buffer containing _GTF taskfile arrays

obj_loc

-- undescribed --

Description

This applies to both PATA and SATA drives.

The _GTF method has no input parameters. It returns a variable number of register set values (registers hex 1F1..1F7, taskfiles). The <variable number> is not known in advance, so have ACPI-CA allocate the buffer as needed and return it, then free it later.

The returned gtf_length and gtf_address are only valid if the function return value is 0.