BusGetDmaAdapter Routine
A BusGetDmaAdapter routine returns a DMA_ADAPTER structure for the target device.
Syntax
PDMA_ADAPTER BusGetDmaAdapter(
__in PVOID Context,
__in PDEVICE_DESCRIPTION DeviceDescriptor,
__out PULONG NumberOfMapRegisters
);
Parameters
Context [in]
A pointer to interface-specific context information that the system provided when the caller queried for the interface.DeviceDescriptor [in]
A pointer to a DEVICE_DESCRIPTION structure that describes the attributes of the physical device.NumberOfMapRegisters [out]
A pointer to, on output, the maximum number of map registers that the driver can allocate for any DMA transfer operation. Caller must allocate a LONG variable to receive this data.
Return Value
BusGetDmaAdapter returns a pointer to a DMA_ADAPTER structure when successful. If an adapter structure cannot be allocated, the routine returns NULL.
Remarks
Typically, driver writers should call IoGetDmaAdapter to obtain this structure.
Requirements
Version |
Available in Windows 2000 and later versions of Windows. |
Header |
Ntddk.h (include Ntddk.h) |
IRQL |
PASSIVE_LEVEL |
See Also
Send comments about this topic to Microsoft
Build date: 1/12/2011