Fonction WdfStringGetUnicodeString (wdfstring.h)

  • Article

[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)

Voir aussi

UNICODE_STRING

WdfStringCreate