DEVPROP_TYPE_NTSTATUS

L’identificateur de DEVPROP_TYPE_NTSTATUS représente l’identificateur de type de données de base pour les valeurs de code NTSTATUS status définies dans Ntstatus.h.

Notes

Dans Windows Vista et les versions ultérieures de Windows, le modèle de propriété d’appareil unifié définit également un identificateur DEVPROP_TYPE_ERROR de type de données de base pour les valeurs de code d’erreur Microsoft Win32.

Vous pouvez combiner DEVPROP_TYPE_NTSTATUS uniquement avec le modificateur de type de données de propriété DEVPROP_TYPEMOD_ARRAY .

Définition d’une propriété de ce type

Pour définir une propriété dont le type de données de base est DEVPROP_TYPE_NTSTATUS, appelez la fonction de propriété SetupDiSetXxx correspondante et définissez les paramètres d’entrée de la fonction comme suit :

• Définissez le paramètre PropertyType sur DEVPROP_TYPE_NTSTATUS.

• Définissez le paramètre PropertyBuffer sur un pointeur vers une mémoire tampon qui peut contenir au moins une valeur NTSTATUS.

• Définissez le paramètre PropertyBufferSize sur sizeof(NTSTATUS).

• Définissez les paramètres de fonction restants comme il convient pour définir la propriété.

Récupération du texte descriptif pour une valeur de code d’erreur NTSTATUS

Pour récupérer le texte descriptif associé à une valeur de code d’erreur NTSTATUS, appelez la fonction FormatMessage (documentée dans le SDK Windows) comme suit :

• Incluez un OR au niveau du bit de l’indicateur FORMAT_MESSAGE_FROM_SYSTEM et l’indicateur FORMAT_MESSAGE_FROM_HMODULE dans la valeur du paramètre dwflags .

• Définissez le paramètre lpSource sur un handle sur le module NtDLL.dll , qui est la source du texte descriptif.

• Définissez le paramètre dwMessageID sur la valeur du code d’erreur.

• Définissez les autres options et paramètres appropriés pour récupérer le texte descriptif.

Spécifications

Voir aussi

DEVPROP_TYPE_ERROR

DEVPROP_TYPEMOD_ARRAY