DMA_TRANSFER_INFO structure (wdm.h)

The DMA_TRANSFER_INFO structure is a container for a DMA_TRANSFER_INFO_XXX structure that describes the allocation requirements for a scatter/gather list.

Syntax

typedef struct _DMA_TRANSFER_INFO {
  ULONG Version;
  union {
    DMA_TRANSFER_INFO_V1 V1;
    DMA_TRANSFER_INFO_V2 V2;
  };
} DMA_TRANSFER_INFO, *PDMA_TRANSFER_INFO;

Members

Version

The version number of the DMA_TRANSFER_INFO_XXX structure that follows this member. For a DMA_TRANSFER_INFO_V1 structure, set this member to DMA_TRANSFER_INFO_VERSION1 before calling the GetDmaTransferInfo routine.

V1

The allocation requirements for a scatter/gather list. For more information, see DMA_TRANSFER_INFO_V1.

V2

The allocation requirements for a scatter/gather list. For more information, see DMA_TRANSFER_INFO_V2.

Remarks

A device driver calls the GetDmaTransferInfo routine to obtain a DMA_TRANSFER_INFO structure that describes the allocation requirements for the scatter/gather list to use in a DMA transfer.

The unnamed union in this structure contains a DMA_TRANSFER_INFO_XXX structure. The Version member indicates which version of the DMA_TRANSFER_INFO_XXX structure is contained in the union.

Requirements

Requirement Value
Minimum supported client Supported starting with Windows 8.
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

See also

DMA_TRANSFER_INFO_V1

GetDmaTransferInfo