Compartilhar via


DEVPROP_TYPE_NTSTATUS

O identificador DEVPROP_TYPE_NTSTATUS representa o identificador de tipo de dados base para os valores de código status NTSTATUS definidos em Ntstatus.h.

Comentários

No Windows Vista e em versões posteriores do Windows, o modelo de propriedade do dispositivo unificado também define um identificador de tipo de dados base DEVPROP_TYPE_ERROR para valores de código de erro do Microsoft Win32.

Você pode combinar DEVPROP_TYPE_NTSTATUS somente com o modificador DEVPROP_TYPEMOD_ARRAY property-data-type.

Definindo uma propriedade desse tipo

Para definir uma propriedade cujo tipo de dados base é DEVPROP_TYPE_NTSTATUS, chame a função de propriedade SetupDiSetXxx correspondente e defina os parâmetros de entrada da função da seguinte maneira:

  • Defina o parâmetro PropertyType como DEVPROP_TYPE_NTSTATUS.

  • Defina o parâmetro PropertyBuffer como um ponteiro para um buffer que pode conter pelo menos um valor NTSTATUS.

  • Defina o parâmetro PropertyBufferSize como sizeof(NTSTATUS).

  • Defina os parâmetros de função restantes conforme apropriado para definir a propriedade .

Recuperando o texto descritivo para um valor de código de erro NTSTATUS

Para recuperar o texto descritivo associado a um valor de código de erro NTSTATUS, chame a função FormatMessage (documentada no SDK do Windows) da seguinte maneira:

  • Inclua um OR bit a bit do sinalizador FORMAT_MESSAGE_FROM_SYSTEM e o sinalizador FORMAT_MESSAGE_FROM_HMODULE no valor do parâmetro dwflags .

  • Defina o parâmetro lpSource como um identificador para o módulo NtDLL.dll , que é a origem do texto descritivo.

  • Defina o parâmetro dwMessageID como o valor do código de erro.

  • Defina as outras opções e parâmetros conforme apropriado para recuperar o texto descritivo.

Requisitos

Versão

Windows Vista e versões posteriores do Windows.

Cabeçalho

Devpropdef.h (inclua Devpropdef.h)

Confira também

DEVPROP_TYPE_ERROR

DEVPROP_TYPEMOD_ARRAY