SVR5 and SCO OpenServer 5

ReleaseDMA(D3pccard)

ReleaseDMA -- release DMA channel

Synopsis

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

Description

ReleaseDMA( ) requests CardServices to access a card's configuration data and release a DMA channel it had assigned to a 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: usDesiredChannle in the RelReqDMA_t structure does not match ucAssignedChannel received from the RequestDMA(D3pccard) service.
BAD_HANDLE: Client handle not valid.
BAD_SOCKET: Socket invalid.
CONFIGURATION_LOCKED: Configuration not released
SUCCESS: Configuration and DMA channel released.

Usage

ReleaseDMA( ) is called as part of client removal to release a DMA channel that was allocated with the RequestDMA(D3pccard) request that is now being cancelled. The logical socket, desired channel, attributes, and assigned channel pointed to by *pRelReqDMA must match those that had been returned by the previous call to RequestDMA(D3pccard).

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), RequestDMA(D3pccard)

config(D2pccard), halt(D2pccard), _unload(D2pccard)