CPNATFWT_BUFFER Structure

  • Article

[This documentation is preliminary and is subject to change.]

The CPNATFWT_BUFFER structure represents a buffer or a chain of buffers used by the Connectivity Platform (CP) and Providers.

Syntax

typedef struct _CPNATFWT_BUFFER {
  CPNATFWT_BUFFER *next;
  ULONG           size;
  BYTE *           buffer;
} CPNATFWT_BUFFER;

Members

  • next
    A pointer to the next buffer in a chain of buffers. If this member is NULL, then this is the last buffer in the chain of buffers.

  • size
    The size, in bytes, of the buffer pointed to by the buffer member.

  • buffer
    A pointer to the buffer used by the Connectivity Platform (CP) and Providers.

Remarks

The CPNATFWT_BUFFER structure is used by the Connectivity Platform feature supported on Windows 7 and later.

The Connectivity Platform (CP) provides a mechanism for specialized applications and services to provide custom network traversal of network address translation (NAT) and firewalls on Windows 7 and later. A Provider registers with the Connectivity Platform to provide network traversal for other applications that use standard Windows networking APIs such as Windows Sockets.

The CPNATFWT_BUFFER structure represents a buffer or a chain of buffers used by the Connectivity Platform (CP) and Providers.

A pointer to a CPNATFWT_BUFFER structure is passed in the bufferChain parameter to the CPNatfwtIndicateReceivedBuffers function when a Provider instance receives data from a peer to indicate to the Connectivity Platform that received buffers are available.

A pointer to a CPNATFWT_BUFFER structure is passed in the bufferChain parameter to the CPNATFWT_PROVIDER_SEND_BUFFERS function implemented by a Provider. This function is called by the Connectivity Platform when there is outgoing traffic generated by an application and the Connectivity Platform has determined that the destination Transport ID is unambiguously reachable over the Provider instance.

Requirements

Minimum supported client Windows 7
Minimum supported server None supported
Header Iphlpapi.h (include Iphlpapi.h)

See Also

CPNATFWT_PROVIDER_SEND_BUFFERS
CPNatfwtIndicateReceivedBuffers

Send comments about this topic to Microsoft

Build date: 2/3/2009