IPv6ObtainPacketData function

Article
06/19/2017

The IPv6ObtainPacketData function retrieves the packet data from an IPv6 packet.

Syntax

uchar* IPv6ObtainPacketData(
  _In_ const void *PacketContext,
  _In_       uint DataLength,
  _In_       uint Alignment
);

Parameters

PacketContext [in]
The packet context associated with an IPv6 network packet. An IPv6 firewall-hook driver specifies the value that the IPv6 network stack passed as the PacketContext parameter to the driver's FirewallHook function for this parameter.
DataLength [in]
The length, in bytes, of packet data that the IPv6 firewall-hook driver is requesting from the IPv6 packet. This must be less than or equal to the value that the IPv6 network stack passed as the DataLength parameter to the driver's FirewallHook function.
Alignment [in]
The requested byte alignment of the returned data pointer. This must be a power-of-two value that indicates the requested byte alignment. For example, a value of 8 specifies that the data is to be 8-byte aligned.

Return value

IPv6ObtainPacketData returns a constant pointer to a contiguous block of memory containing the packet data, or NULL if an error occurred.

Remarks

An IPv6 firewall-hook driver calls the IPv6ObtainPacketData function from within its FirewallHook function if it needs to examine the packet data to determine whether the network packet should be accepted or dropped.

Requirements

Target platform	Desktop
Version	Available on Microsoft Windows XP with Service Pack 2 (SP2) and Windows Server 2003 with Service Pack 1 (SP1).
Header	Ip6firewall.h (include Ip6firewall.h)
Library	Tcpip6.lib
IRQL	Any level

Partager via