Share via

NdisBufferVirtualAddress

  • Article

This function returns the base virtual address for the buffer mapped by a given buffer descriptor. It maps the physical pages described by the given buffer descriptor onto system space if these pages are not already mapped to system space.

PVOID NdisBufferVirtualAddress(
  PNDIS_BUFFER Buffer
);

Parameters

  • Buffer
    [in] Points to a buffer descriptor from which the base virtual address is to be returned.

Return Values

Returns the base system-space virtual address that maps the physical pages described by the given buffer descriptor.

Remarks

Drivers should call NdisBufferVirtualAddressSafe instead of NdisBufferVirtualAddress. NDIS 5.1 miniport drivers must call NdisBufferVirtualAddressSafe instead of NdisBufferVirtualAddress. Unlike NdisBufferVirtualAddress, NdisBufferVirtualAddressSafe does not cause a bug check if system resources are low or exhausted.

Drivers of PIO devices call this routine to translate a virtual address range, described by the buffer, for a user buffer to a system-space address range.

The returned base address has the same offset as the virtual address in the buffer.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Ndis.h.

See Also

NdisAllocateBuffer | NdisAllocateBufferPool | NdisAllocateMemory | NdisFreeBuffer | NdisBufferVirtualAddressSafe

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.