Condividi tramite


Funzione NdisInitializeString (ndis.h)

La funzione NdisInitializeString alloca l'archiviazione per e inizializza una stringa con conteggiata nel set di caratteri predefinito del sistema.

Sintassi

void NdisInitializeString(
  PNDIS_STRING Destination,
  PUCHAR       Source
);

Parametri

Destination

Puntatore a un NDIS_STRING con un buffer NULL. In caso di restituzione da questa funzione, il NDIS_STRING contiene una stringa con conteggiata inizializzata. Per Windows 2000 e versioni successive, NDIS definisce il tipo di NDIS_STRING come tipo UNICODE_STRING.

Source

Puntatore a una stringa con terminazione Null con cui inizializzare la stringa con conteggiata. SourceString non deve essere NULL.

Valore restituito

Nessuno

Osservazioni

NdisInitializeString imposta il Length e MaximumLength membri di NDIS_STRING per la stringa di destinazione e termina la stringa di destinazione con zero. Per i driver Windows 2000 e versioni successive,NdisInitializeString converte la stringa di origine fornita in caratteri Unicode.

SourceString non deve essere NULL.

Il buffer allocato da NdisInitializeString deve essere rilasciato con la funzione NdisFreeString.

Fabbisogno

Requisito Valore
client minimo supportato Supportato per i driver esistenti in NDIS 6.0 e versioni successive, ma i nuovi driver devono usare invece RtlInitUnicodeString o RTL_CONSTANT_STRING o DECLARE_CONST_UNICODE_STRING (vedere ntdef.h).
piattaforma di destinazione Universale
intestazione ndis.h (include Ndis.h)
libreria Ndis.lib
IRQL PASSIVE_LEVEL
regole di conformità DDI Irql_Miscellaneous_Function(ndis)

Vedere anche

ANSI_STRING

DriverEntry dei driver del protocollo NDIS

MiniportInitializeEx

RtlAnsiStringToUnicodeString

RtlEqualUnicodeString

RtlFreeAnsiString

RtlFreeUnicodeString

RtlInitString

RtlInitUnicodeString

RtlUnicodeStringToAnsiString

UNICODE_STRING