DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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)


19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005