Compartir a través de


DEVPROP_TYPE_NTSTATUS

El identificador de DEVPROP_TYPE_NTSTATUS representa el identificador de tipo de datos base para los valores de código de estado NTSTATUS definidos en Ntstatus.h.

Observaciones

En Windows Vista y versiones posteriores de Windows, el modelo de propiedades de dispositivo unificado también define un identificador de tipo de datos base DEVPROP_TYPE_ERROR para los valores de código de error de Microsoft Win32.

Solo puede combinar DEVPROP_TYPE_NTSTATUS con el modificador property-data-type de DEVPROP_TYPEMOD_ARRAY .

Establecer una propiedad de este tipo

Para establecer una propiedad cuyo tipo de datos base sea DEVPROP_TYPE_NTSTATUS, llame a la función de propiedad SetupDiSetXxx correspondiente y establezca los parámetros de entrada de función de la siguiente manera:

  • Establezca el parámetro PropertyType en DEVPROP_TYPE_NTSTATUS.

  • Establezca el parámetro PropertyBuffer en un puntero a un búfer que pueda contener al menos un valor NTSTATUS.

  • Establezca el parámetro PropertyBufferSize en sizeof(NTSTATUS).

  • Establezca los parámetros de función restantes según corresponda para establecer la propiedad .

Recuperar el texto descriptivo para un valor de código de error NTSTATUS

Para recuperar el texto descriptivo asociado a un valor de código de error NTSTATUS, llame a la función FormatMessage (documentada en Windows SDK) de la siguiente manera:

  • Incluya un OR bit a bit de la marca FORMAT_MESSAGE_FROM_SYSTEM y la marca FORMAT_MESSAGE_FROM_HMODULE en el valor del parámetro dwflags .

  • Establezca el parámetro lpSource en un identificador para el módulo NtDLL.dll , que es el origen del texto descriptivo.

  • Establezca el parámetro dwMessageID en el valor del código de error.

  • Establezca las demás opciones y parámetros según corresponda para recuperar el texto descriptivo.

Requisitos

Versión

Windows Vista y versiones posteriores de Windows.

Encabezado

Devpropdef.h (incluya Devpropdef.h)

Consulte también

DEVPROP_TYPE_ERROR

DEVPROP_TYPEMOD_ARRAY