NdisInitializeString-Funktion (ndis.h)
Die NdisInitializeString-Funktion weist Speicher für und initialisiert eine gezählte Zeichenfolge im Systemstandardzeichensatz.
Syntax
void NdisInitializeString(
PNDIS_STRING Destination,
PUCHAR Source
);
Parameter
Destination
Ein Zeiger auf eine NDIS_STRING mit einem NULL-Puffer . Bei der Rückgabe von dieser Funktion enthält die NDIS_STRING eine initialisierte, gezählte Zeichenfolge. Für Windows 2000 und höher definiert NDIS den NDIS_STRING-Typ als UNICODE_STRING Typ.
Source
Ein Zeiger auf eine NULL-Zeichenfolge, mit der die gezählte Zeichenfolge initialisiert werden soll. SourceString darf nicht NULL sein.
Rückgabewert
Keine
Bemerkungen
NdisInitializeString legt die Length - und MaximumLength-Member von NDIS_STRING für die Zielzeichenfolge fest und beendet die Zielzeichenfolge mit null. Für Windows 2000- und höhere Treiber konvertiert NdisInitializeString die angegebene Quellzeichenfolge in Unicode-Zeichen.
SourceString darf nicht NULL sein.
Der von NdisInitializeString zugewiesene Puffer sollte mit der NdisFreeString-Funktion freigegeben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Wird für vorhandene Treiber in NDIS 6.0 und höher unterstützt, aber neue Treiber sollten stattdessen RtlInitUnicodeString oder RTL_CONSTANT_STRING oder DECLARE_CONST_UNICODE_STRING (siehe ntdef.h) verwenden. |
| Zielplattform | Universell |
| Header | ndis.h (einschließlich Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |