card

Index

BeginCardAccess()	CardAccessSpeed()	CardChangeCount()	CardForceChange()
CardInterface()	CardMiscControl()	CardProgramVoltage()	CardResetCard()
CardResetRemove()	CopyTuple()	DeviceTuple()	EndCardAccess()
GetCardMap()	IfAmigaXIP()	OwnCard()	ReadCardStatus()
ReleaseCard()

BeginCardAccess()

Synopsis

BOOL BeginCardAccess(
   struct CardHandle *handle)

Function

Generic fallback: report that card access cannot begin.

Inputs

handle - Unused.

Result

Always FALSE.

Notes

No ownership check, locking or hardware access is performed.

CardAccessSpeed()

Synopsis

ULONG CardAccessSpeed(
   struct CardHandle *handle, ULONG nanoseconds)

Function

Generic fallback: reject a card-access timing request.

Inputs

handle - Unused.
nanoseconds - Unused.

Result

Always zero. No access speed is selected.

CardChangeCount()

Synopsis

ULONG CardChangeCount(
   )

Function

Generic fallback: return no recorded card changes.

Result

Always zero. No change counter is maintained.

CardForceChange()

Synopsis

BOOL CardForceChange(
   )

Function

Generic fallback: generate no card-change notification.

Result

Always FALSE.

CardInterface()

Synopsis

ULONG CardInterface(
   )

Function

Identify the generic resource as having no supported card interface.

Result

(ULONG)-1. This is not CARD_INTERFACE_AMIGA_0.

CardMiscControl()

Synopsis

UBYTE CardMiscControl(
   struct CardHandle *handle, UBYTE control_bits)

Function

Generic fallback: leave card controls unchanged.

Inputs

handle - Unused.
control_bits - Unused.

Result

Always zero.

CardProgramVoltage()

Synopsis

LONG CardProgramVoltage(
   struct CardHandle *handle, ULONG voltage)

Function

Generic fallback: reject a programming-voltage request.

Inputs

handle - Unused.
voltage - Unused.

Result

Always -1. No voltage is changed.

CardResetCard()

Synopsis

BOOL CardResetCard(
   struct CardHandle *handle)

Function

Generic fallback: perform no card reset.

Inputs

handle - Unused.

Result

Always FALSE.

CardResetRemove()

Synopsis

BOOL CardResetRemove(
   struct CardHandle *handle, ULONG flag)

Function

Generic fallback: leave removal-reset behaviour unchanged.

Inputs

handle - Unused.
flag - Unused.

Result

Always FALSE.

CopyTuple()

Synopsis

BOOL CopyTuple(
   struct CardHandle *handle, UBYTE *buffer, ULONG tuplecode, ULONG size)

Function

Generic fallback: copy no card tuple.

Inputs

handle - Unused.
buffer - Unused; not written.
tuplecode - Unused.
size - Unused.

Result

Always FALSE. The output buffer is unchanged.

DeviceTuple()

Synopsis

ULONG DeviceTuple(
   UBYTE *tuple_data, struct DeviceTData *storage)

Function

Generic fallback: decode no device tuple.

Inputs

tuple_data - Unused; not read.
storage - Unused; not written.

Result

Always zero. The output structure is unchanged.

EndCardAccess()

Synopsis

BOOL EndCardAccess(
   struct CardHandle *handle)

Function

Generic fallback: report that card access cannot end.

Inputs

handle - Unused.

Result

Always FALSE.

Notes

No ownership check, locking or hardware access is performed.

GetCardMap()

Synopsis

struct CardMemoryMap * GetCardMap(
   )

Function

Return the memory-map structure embedded in the generic resource.

Result

A borrowed pointer to the resource-owned CardMemoryMap.

Notes

Do not modify or free the structure. Its lifetime is that of the
resource. This implementation does not populate hardware addresses
or sizes; the returned pointer does not establish an accessible card
mapping. The m68k-Amiga resource supplies a separate hardware map.

IfAmigaXIP()

Synopsis

struct Resident * IfAmigaXIP(
   struct CardHandle *handle)

Function

Generic fallback: return no execute-in-place resident.

Inputs

handle - Unused.

Result

Always NULL.

OwnCard()

Synopsis

struct CardHandle * OwnCard(
   struct CardHandle *handle)

Function

Generic fallback: leave card ownership unchanged.

Inputs

handle - Unused; not read, modified or retained.

Result

Always NULL. This does not indicate acquired ownership.

Bugs

This implementation does not register the handle or grant card
access. Do not interpret NULL using the m68k-Amiga ownership
convention.

ReadCardStatus()

Synopsis

UBYTE ReadCardStatus(
   )

Function

Generic fallback: return no card-status bits.

Result

Always zero. No hardware status is read.

ReleaseCard()

Synopsis

void ReleaseCard(
   struct CardHandle *handle, ULONG flags)

Function

Generic fallback: perform no release operation.

Inputs

handle - Unused.
flags - Unused.

Result

None.