NdisInitUnicodeString function

The NdisInitUnicodeString function initializes a counted Unicode string.

Syntax


VOID NdisInitUnicodeString(
  _Inout_  PNDIS_STRING DestinationString,
  _In_     PCWSTR SourceString
);

Parameters

DestinationString [in, out]

A pointer to a caller-allocated NDIS_STRING type in which NdisInitUnicodeString should store the counted Unicode string. For Windows 2000 and later, NDIS defines the NDIS_STRING type as a UNICODE_STRING type.

SourceString [in]

A pointer to a null-terminated string with which to initialize the counted string.

Return value

None

Remarks

The DestinationString is initialized to point to the SourceString . The Length and MaximumLength members of NDIS_STRING for the DestinationString are initialized to the length of the string at SourceString. If SourceString is NULL, the length is zero.

Callers of NdisInitUnicodeString 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

Version

Supported for NDIS 6.0 and NDIS 5.1 drivers (see NdisInitUnicodeString (NDIS 5.1)) in Windows Vista. Supported for NDIS 5.1 drivers (see NdisInitUnicodeString (NDIS 5.1)) in Windows XP.

Header

Ndis.h (include Ndis.h)

IRQL

See Remarks section

DDI compliance rules

Irql_Miscellaneous_Function

See also

DriverEntry of NDIS Protocol Drivers
MiniportInitializeEx
NdisAnsiStringToUnicodeString
NdisInitAnsiString
NdisInitializeString
NdisUnicodeStringToAnsiString
ProtocolBindAdapterEx
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft