Función NdisInitializeString (ndis.h)
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) |