Función NdisInitializeString (ndis.h)
La función NdisInitializeString asigna almacenamiento para e inicializa una cadena con recuento 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 con recuento. SourceString no debe ser NULL.
Valor devuelto
Ninguno
Observaciones
NdisInitializeString establece el de longitud y miembros 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 | Valor |
|---|---|
| cliente mínimo admitido | Se admite para 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. |
| de la plataforma de destino de | Universal |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | Irql_Miscellaneous_Function(ndis) |