Next: 2.15 WD_DMASyncCpu() Up: 2. WD_xxx PCI/PCMCIA/ISA Functions Previous: 2.13 WD_DMALock() Contents

2.14 WD_DMAUnlock()

PURPOSE

$\bullet$ Unlocks a DMA buffer.

PROTOTYPE

DWORD WD_DMAUnlock(
    HANDLE hWD,
    WD_DMA *pDMA);

PARAMETERS

Name Type Input/Output

$\bullet$ hWD HANDLE Input

$\bullet$ pDma WD_DMA*

$\gg$ hDma DWORD Input

$\gg$ pUserAddr PVOID N/A

$\gg$ pKernelAddr KPTR N/A

$\gg$ dwBytes DWORD N/A

$\gg$ dwOptions DWORD N/A

$\gg$ dwPages DWORD N/A

$\gg$ hCard DWORD N/A

$\gg$ Page WD_DMA_PAGE[WD_DMA_PAGES] N/A

Name	Type	Input/Output
$\bullet$ hWD	HANDLE	Input
$\bullet$ pDma	WD_DMA*
$\gg$ hDma	DWORD	Input
$\gg$ pUserAddr	PVOID	N/A
$\gg$ pKernelAddr	KPTR	N/A
$\gg$ dwBytes	DWORD	N/A
$\gg$ dwOptions	DWORD	N/A
$\gg$ dwPages	DWORD	N/A
$\gg$ hCard	DWORD	N/A
$\gg$ Page	WD_DMA_PAGE[WD_DMA_PAGES]	N/A

DESCRIPTION

Name Description

hWD Handle to WinDriver's kernel-mode driver as received from WD_Open() [5.2]

pDMA Pointer to a DMA information structure:

$\bullet$ hDma DMA buffer handle, received from WD_DMALock() [2.13].

Name	Description
hWD	Handle to WinDriver's kernel-mode driver as received from `WD_Open()` [5.2]
pDMA	Pointer to a DMA information structure:
$\bullet$ hDma	DMA buffer handle, received from `WD_DMALock()` [2.13].

RETURN VALUE

Returns WD_STATUS_SUCCESS (0) on success, or an appropriate error code otherwise [A].

EXAMPLE

WD_DMAUnlock(hWD, &dma);