do_drive_get_GTF — get the drive bootup default taskfile settings
int do_drive_get_GTF ( | struct ata_port * | ap, |
int | ix, | |
unsigned int * | gtf_length, | |
unsigned long * | gtf_address, | |
unsigned long * | obj_loc) ; |
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 --
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.