NdisMStartBufferPhysicalMapping (Windows Embedded CE 6.0)

1/6/2010

This function initializes mapping for a busmaster DMA transfer operation.

Syntax

NdisMStartBufferPhysicalMapping(
  NDIS_HANDLE MiniportAdapterHandle,
  PNDIS_BUFFER Buffer,
  ULONG PhysicalMapRegister,
  BOOLEAN WriteToDevice,
  PNDIS_PHYSICAL_ADDRESS_UNIT PhysicalAddressArray,
  PUINT ArraySize
);

Parameters

• MiniportAdapterHandle
  [in] Specifies the handle originally used in input to MiniportInitialize.

• Buffer
  [in] Pointer to a buffer descriptor mapping the virtual range for the transfer. This buffer contains the data to be transferred.

• PhysicalMapRegister
  [in] Not used.

• WriteToDevice
  [in] Specifies TRUE when the mapping is used for an outbound transfer from the system through the NIC.

• PhysicalAddressArray
  Pointer to a caller-supplied array of NDIS_PHYSICAL_UNIT structures.

• ArraySize
  Pointer to a caller-supplied variable in which NdisMStartBufferPhysicalMapping returns the number of ranges it mapped in the buffer at PhysicalAddressArray. This value is a count of the elements that contain mappings so the caller can use this count as a bound on the number of physical address ranges it downloads to the NIC subsequently.

Return Value

None.

Requirements

See Also

Reference

NDIS Library Functions
NdisFlushBuffer
NdisMAllocateSharedMemory
NdisMCompleteBufferPhysicalMapping
NdisMUpdateSharedMemory