Expand Minimize

WdfDmaEnablerGetMaximumLength method

[Applies to KMDF only]

The WdfDmaEnablerGetMaximumLength method returns the maximum transfer length, for a single DMA transfer, that a device supports.

Syntax


size_t WdfDmaEnablerGetMaximumLength(
  [in]  WDFDMAENABLER DmaEnabler
);

Parameters

DmaEnabler [in]

A handle to a DMA enabler object that the driver obtained from a previous call to WdfDmaEnablerCreate.

Return value

WdfDmaEnablerGetMaximumLength returns the maximum length of a DMA transfer, in bytes. This length is the same value that was specified in a previous call to WdfDmaEnablerCreate.

A bug check occurs if the driver supplies an invalid object handle.

Examples

The following code example obtains the maximum transfer length that a device supports for a DMA transfer.


size_t  length;

length = WdfDmaEnablerGetMaximumLength(DmaEnabler);

Requirements

Minimum KMDF version

1.0

Header

Wdfdmaenabler.h (include Wdf.h)

Library

Wdf01000.sys (see Framework Library Versioning.)

IRQL

<=DISPATCH_LEVEL

DDI compliance rules

DriverCreate, KmdfIrql, KmdfIrql2

See also

WDF_DMA_ENABLER_CONFIG
WdfDmaEnablerCreate
WdfDmaEnablerGetFragmentLength

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft