ADC Home > Reference Library > Reference > Darwin > Kernel Framework Reference

---

ATADeviceNub

Overview

A concrete implementation of IOATADevice.

Discussion

Clients of IOATA (disk drivers) should use the interface presented by IOATADevice. Concrete nubs are private to the IOATA family and specific subclasses of IOATADevice are instantiated by controller drivers to provide the abstract interface to clients.

---

Functions

allocCommand

Creates command objects for clients.

ataDeviceNub

Creates nubs.

attach

Overrides the IOService method.

executeCommand

Submits IO requests.

freeCommand

Disposes of command objects.

getDeviceID

Gets the unit ID of this drive (0 or 1).

init

Initializes the nub.

MyATACallback

To be deprecated.

processCallback

To be deprecated.

publishBusProperties

Puts info about this device's bus capability in the device tree.

publishProperties

Publishes the nub's properties in the device tree.

publishVendorProperties

Will be deprecated.

swapBytes16

To be deprecated.

---

allocCommand

---

Creates command objects for clients.

public

virtual IOATACommand* allocCommand(
    void ); 

---

ataDeviceNub

---

Creates nubs.

public

static ATADeviceNub* ataDeviceNub(
    IOATAController *provider,
    ataUnitID unit,
    ataDeviceType devType); 

Discussion

ataDeviceNub is a static creator function that is used by IOATAControllers to create nubs.

---

attach

---

Overrides the IOService method.

public

virtual bool attach(
    IOService *provider ); 

---

executeCommand

---

Submits IO requests.

public

virtual IOReturn executeCommand(
    IOATACommand *command); 

---

freeCommand

---

Disposes of command objects.

public

virtual void freeCommand(
    IOATACommand *inCommand); 

Discussion

Clients use this method to dispose of command objects.

---

getDeviceID

---

Gets the unit ID of this drive (0 or 1).

protected

virtual IOReturn getDeviceID(
    void); 

---

init

---

Initializes the nub.

protected

virtual bool init(
    IOATAController *provider,
    ataUnitID unit,
    ataDeviceType devType); 

Discussion

This function is used after creating the nub.

---

MyATACallback

---

To be deprecated.

protected

static void MyATACallback(
    IOATACommand *command ); 

---

processCallback

---

To be deprecated.

protected

void processCallback(
    IOATACommand *command ); 

---

publishBusProperties

---

Puts info about this device's bus capability in the device tree.

protected

virtual void publishBusProperties(
    void); 

---

publishProperties

---

Publishes the nub's properties in the device tree.

protected

virtual void publishProperties(
    void ); 

---

publishVendorProperties

---

Will be deprecated.

protected

virtual void publishVendorProperties(
    void ); 

---

swapBytes16

---

To be deprecated.

protected

void swapBytes16(
    UInt8 *dataBuffer,
    IOByteCount length); 

Structs and Unions

---

ExpansionData

---

protected

struct ExpansionData {
}; 

Discussion

This structure will be used to expand the capablilties of the ATADeviceNub in the future.

Member Data

---

reserved

---

protected

ExpansionData *reserved; 

Discussion

Reserved for future use. (Internal use only)

Did this document help you? Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.

 

Last Updated: 2008-12-19