SVR5 and SCO OpenServer 5

RequestDMA(D3pccard)

RequestDMA -- bind DMA channel to client's 16-bit card

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (RequestDMA, ClientHandle_t *pClientHandle,
                     int n1, int RelReqDMALen,
                     RelReqDMA_t *pRelReqDMA, rm_key_t key);

Description

RequestDMA( ) requests CardServices to access a card's configuration data and bind a DMA channel to a Client's 16-bit card.

Arguments

pClientHandle: Pointer to a ClientHandle(D4pccard) structure.
n1: NULL
RelReqDMALen: Length of the RelReqDMA(D4pccard) structure. Must be set to 6.
pRelReqDMA: Pointer to a RelReqDMA(D4pccard) structure.
key: Resource manager key.

Return values

BAD_ARG_LENGTH: RelReqDMALen not equal to 6.
BAD_ARGS: DMA channel with width specified in the usAttributes member of the RelReqDMA structure is not available.
BAD_HANDLE: Client handle not valid.
BAD_SOCKET: Socket invalid.
CONFIGURATION_LOCKED: Earlier configuration not released.
IN_USE: Requested DMA channel already assigned.
NO_CARD: No card inserted.
SUCCESS: DMA channel bound to client and card.

Usage

RequestDMA( ) is called as part of client configuration to request system resources for the card. The logical socket, desired channel, attributes, and assigned channel are in passed to CardServices in the RelReqDMA(D4pccard) structure. Do not use this service if the card does not need a DMA channel. When invoked, this service must be called before the RequestConfiguration(D3pccard) service.

Context and synchronization

Interrupt, initialization, or user context

Hardware applicability

16-bit PC Card only.

Version applicability

pccard: 1, 2, 3

References

ClientHandle(D4pccard), RelReqDMA(D4pccard)