DEVPROP_TYPE_NTSTATUS

DEVPROP_TYPE_NTSTATUS标识符表示 Ntstatus.h 中定义的 NTSTATUS 状态代码值的基数据类型标识符。

注解

在 Windows Vista 和更高版本的 Windows 中, 统一设备属性模型 还为 Microsoft Win32 错误代码值定义 DEVPROP_TYPE_ERROR base-data-type 标识符。

只能将DEVPROP_TYPE_NTSTATUS与 DEVPROP_TYPEMOD_ARRAY property-data-type 修饰符组合使用。

设置此类型的属性

若要设置基数据类型为DEVPROP_TYPE_NTSTATUS的属性,请调用相应的 SetupDiSetXxx 属性函数并设置函数输入参数,如下所示:

  • PropertyType 参数设置为DEVPROP_TYPE_NTSTATUS。

  • PropertyBuffer 参数设置为指向可以包含至少一个 NTSTATUS 值的缓冲区的指针。

  • PropertyBufferSize 参数设置为 sizeof (NTSTATUS)

  • 根据需要设置剩余的函数参数以设置 属性。

检索 NTSTATUS 错误代码值的描述性文本

若要检索与 NTSTATUS 错误代码值关联的描述性文本, (Windows SDK) 中所述调用 FormatMessage 函数,如下所示:

  • dwflags 参数的值中包含FORMAT_MESSAGE_FROM_SYSTEM标志和FORMAT_MESSAGE_FROM_HMODULE标志的按位 OR。

  • lpSource 参数设置为 NtDLL.dll 模块的句柄,该模块是描述性文本的源。

  • dwMessageID 参数设置为错误代码值。

  • 根据需要设置其他选项和参数以检索描述性文本。

要求

版本

Windows Vista 和更高版本的 Windows。

标头

Devpropdef.h (包括 Devpropdef.h)

另请参阅

DEVPROP_TYPE_ERROR

DEVPROP_TYPEMOD_ARRAY