Función NdisInitializeString (ndis.h)

Artículo
02/27/2024

La función NdisInitializeString asigna almacenamiento para e inicializa una cadena contada en el juego de caracteres predeterminado del sistema.

Sintaxis

void NdisInitializeString(
  PNDIS_STRING Destination,
  PUCHAR       Source
);

Parámetros

Destination

Puntero a un NDIS_STRING con un búfer NULL . Al devolver de esta función, el NDIS_STRING contiene una cadena inicializada y con recuento. Para Windows 2000 y versiones posteriores, NDIS define el tipo de NDIS_STRING como un tipo de UNICODE_STRING .

Source

Puntero a una cadena terminada en null con la que inicializar la cadena contada. SourceString no debe ser NULL.

Valor devuelto

None

Observaciones

NdisInitializeString establece los miembros Length y MaximumLength de NDIS_STRING para la cadena de destino y finaliza la cadena de destino con cero. Para los controladores de Windows 2000 y versiones posteriores, NdisInitializeString convierte la cadena de origen proporcionada en caracteres Unicode.

SourceString no debe ser NULL.

El búfer asignado por NdisInitializeString debe liberarse con la función NdisFreeString .

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con los controladores existentes en NDIS 6.0 y versiones posteriores, pero los nuevos controladores deben usar RtlInitUnicodeString o RTL_CONSTANT_STRING o DECLARE_CONST_UNICODE_STRING (vea ntdef.h) en su lugar.
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis)