Функция IoIsValidIrpStatus (ntddk.h)

подпрограмма IoIsValidIrpStatus проверяет указанное значение кода состояния NTSTATUS.

Синтаксис

LOGICAL IoIsValidIrpStatus(
  [in] IN NTSTATUS Status
);

Параметры

[in] Status

Код состояния для проверки.

Возвращаемое значение

IoIsValidIrpStatus возвращает значение TRUE, если параметр состояния является хорошо сформированным значением NTSTATUS. В противном случае подпрограмма возвращает FALSE.

Замечания

Разработчики драйверов могут определять пользовательские значения NTSTATUS для использования в качестве кодов состояния для запросов IRP_MJ_INTERNAL_DEVICE_CONTROL. Драйверы могут вызывать IoIsValidIrpStatus для проверки кодов состояния этих запросов. Эта подпрограмма полезна для обнаружения неинициализированного или поврежденного значения состояния в блоке состояния ввода-вывода IRP.

IoIsValidIrpStatus обнаруживает недопустимые коды состояния, которые, очевидно, нарушают правила определения пользовательских значений NTSTATUS, но могут не обнаруживать недопустимые коды состояния, которые, как представляется, следуют правилам. Подпрограмма может возвращать TRUE для параметра состояния, который не является допустимым значением кода NTSTATUS, но редко возвращает FALSE для допустимого кода NTSTATUS.

IoIsValidIrpStatus проверяет , объекта и поля кода в значении параметра состояния, чтобы определить, соответствует ли сочетание значений в этих полях опубликованным рекомендациям. Если задан бит C параметра состояния, IoIsValidIrpStatus возвращает TRUE независимо от других значений полей в Status.

Дополнительные сведения об этих полях см. в определении новых значений NTSTATUS.

Требования

См. также

IRP_MJ_INTERNAL_DEVICE_CONTROL