Fonction WdfStringGetUnicodeString (wdfstring.h)
[S’applique à KMDF et UMDF]
La méthode WdfStringGetUnicodeString récupère la chaîne Unicode affectée à un objet de chaîne d’infrastructure spécifié.
Syntaxe
void WdfStringGetUnicodeString(
[in] WDFSTRING String,
[out] PUNICODE_STRING UnicodeString
);
Paramètres
[in] String
Handle d’un objet de chaîne de framework.
[out] UnicodeString
Pointeur vers une structure UNICODE_STRING qui reçoit un pointeur vers la chaîne Unicode actuellement affectée à l’objet string spécifié par String .
Valeur de retour
None
Remarques
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Une fois que WdfStringGetUnicodeString est retourné, la structure UNICODE_STRING vers laquelle UnicodeString pointe contient un pointeur vers la chaîne Unicode de l’objet de chaîne spécifié, ainsi que la longueur de la chaîne. La chaîne Unicode est allouée dans un pool paginé.
L’infrastructure ne copie pas la chaîne du pilote.
Pour plus d’informations sur les objets de chaîne de framework, consultez Utilisation d’objets de chaîne.
Exemples
L’exemple de code suivant obtient la chaîne Unicode affectée à un objet de chaîne d’infrastructure spécifié.
UNICODE_STRING StringName;
WdfStringGetUnicodeString(
stringHandle,
&StringName
);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfstring.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |