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

 


IOFireWireAVCSubUnit

Inherits from:
Declared In:

Overview

nub for sub unit of AVC devices. Just for matching, calls the AVC unit for all functions.



Functions

AVCCommand

Sends an AVC command to the device and stores the response.

AVCCommandInGeneration

Sends an AVC command to the device and stores the response. The command must complete in the specified FireWire bus generation otherwise kIOFireWireBusReset is returned.

handleClose

Overrideable method to control the open / close behaviour of an IOService.

handleOpen

Overrideable method to control the open / close behaviour of an IOService.

matchPropertyTable

Matching language support Match on the following properties of the sub unit: Vendor_ID GUID SubUnit_Type

updateAVCCommandTimeout

By default, AVCCommands timeout 10 seconds after receiving an Interim response. This function resets the timeout of the current command to 10 seconds from the current time. Call this repeatedly for AVC commands that take a very long time to execute to prevent premature timeout.


AVCCommand


Sends an AVC command to the device and stores the response.

public

virtual IOReturn AVCCommand( const UInt8 * command, UInt32 cmdLen, UInt8 * response, UInt32 *responseLen);
Parameters
command

Pointer to command to send.

cmdLen

Length of the command.

response

Pointer to place to store the response.

responseLen

Pointer to response length - initialize to the size of the buffer pointed to by response, updated to the number of bytes returned by the device.


AVCCommandInGeneration


Sends an AVC command to the device and stores the response. The command must complete in the specified FireWire bus generation otherwise kIOFireWireBusReset is returned.

public

virtual IOReturn AVCCommandInGeneration( UInt32 generation, const UInt8 * command, UInt32 cmdLen, UInt8 * response, UInt32 *responseLen);
Parameters
generation

The bus generation that the command must execute in.

command

Pointer to command to send.

cmdLen

Length of the command.

response

Pointer to place to store the response.

responseLen

Pointer to response length - initialize to the size of the buffer pointed to by response, updated to the number of bytes returned by the device.


handleClose


Overrideable method to control the open / close behaviour of an IOService.

public

virtual void handleClose( IOService *forClient, IOOptionBits options );
Parameters
forClient

Designates the client of the provider requesting the close.

options

Options for the close, may be interpreted by the implementor of handleOpen.

Discussion

See IOService for discussion.


handleOpen


Overrideable method to control the open / close behaviour of an IOService.

public

virtual bool handleOpen( IOService *forClient, IOOptionBits options, void *arg );
Parameters
forClient

Designates the client of the provider requesting the open.

options

Options for the open, may be interpreted by the implementor of handleOpen.

Return Value

Return true if the open was successful, false otherwise.

Discussion

See IOService for discussion.


matchPropertyTable


Matching language support Match on the following properties of the sub unit: Vendor_ID GUID SubUnit_Type

public

virtual bool matchPropertyTable( OSDictionary *table);


updateAVCCommandTimeout


By default, AVCCommands timeout 10 seconds after receiving an Interim response. This function resets the timeout of the current command to 10 seconds from the current time. Call this repeatedly for AVC commands that take a very long time to execute to prevent premature timeout.

public

virtual IOReturn updateAVCCommandTimeout();

Structs and Unions


ExpansionData


protected

struct ExpansionData { };
Discussion

This structure will be used to expand the capablilties of the class 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