DEVPROP_TYPE_NTSTATUS

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

Remarks

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

Vous pouvez combiner DEVPROP_TYPE_NTSTATUS uniquement avec le modificateur de type de propriété-données 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 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 selon les besoins 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 une or au niveau du bit de l’indicateur de FORMAT_MESSAGE_FROM_SYSTEM et de l’indicateur de 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.

Requirements

Version	Windows Vista et versions ultérieures de Windows.
En-tête	Devpropdef.h (include Devpropdef.h)

Voir aussi

DEVPROP_TYPE_ERROR

DEVPROP_TYPEMOD_ARRAY