Share via


NdisInitAnsiString (Compact 2013)

3/26/2014

This function initializes a counted ASCII string.

Syntax

VOID NdisInitAnsiString(
  PNDIS_ANSI_STRING DestinationString,
  PCSTR SourceString
);

Parameters

  • DestinationString
    [in, out] Pointer to a caller-allocated buffer in which this function should store the counted ASCII string.
  • SourceString
    [in] Pointer to a 0-terminated string with which to initialize the counted string.

Return Value

None.

Remarks

The DestinationString parameter is initialized to point to the SourceString parameter. The length and maximum length for the DestinationString are initialized to the length of the string at SourceString. If SourceString is NULL, the length is zero.

Callers of NdisInitAnsiString must be running at IRQL <= DISPATCH_LEVEL if the DestinationString buffer is allocated from nonpaged memory. Usually, callers are running at IRQL = PASSIVE_LEVEL during driver initialization.

Requirements

Header

ndis.h

Library

ndis.lib

See Also

Reference

NDIS String Interface
DriverEntry of NDIS Protocol Drivers
MiniportInitializeEx
NdisAnsiStringToUnicodeString
NdisFreeString
NdisInitializeString
NdisInitUnicodeString
NdisUnicodeStringToAnsiString
ProtocolBindAdapterEx