NdisInitUnicodeString (NDIS 5.1) function
Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.
NdisInitUnicodeString initializes a counted Unicode string.
Syntax
VOID NdisInitUnicodeString(
_Inout_ PNDIS_STRING DestinationString,
_In_ PCWSTR SourceString
);
Parameters
DestinationString [in, out]
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]
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
Target platform |
Universal |
Version |
|
Header |
Ndis.h (include Ndis.h) |
Library |
Ndis.lib |
IRQL |
See Remarks section. |
See also
DriverEntry of NDIS Protocol Drivers