.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "SND_MALLOC_SGBUF_PAGES" "" "06 October 2005" "" ""

.SH NAME
snd_malloc_sgbuf_pages \- allocate the pages for the PCI SG buffer
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
void * snd_malloc_sgbuf_pages  (struct pci_dev * \fIpci\fB, size_t \fIsize\fB, struct snd_dma_buffer * \fIdmab\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIpci\fB\fR
the pci device pointer
.TP
\fB\fIsize\fB\fR
the requested buffer size in bytes
.TP
\fB\fIdmab\fB\fR
the buffer record to store
.SH "DESCRIPTION"
.PP
Initializes the SG-buffer table and allocates the buffer pages
for the given size.
The pages are mapped to the virtually continuous memory.
.PP
This function is usually called from the middle-level functions such as
\fBsnd_pcm_lib_malloc_pages\fR\&.
.PP
Returns the mapped virtual address of the buffer if allocation was
successful, or NULL at error.