使用 NTSTATUS 值

注意

如果您要尋找 NTSTATUS 值對應至對應 Win32 錯誤碼的資料表，請參閱 NTSTATUS 到 Win32 錯誤碼對應。

許多核心模式 標準驅動程式常式 和驅動程式支援常式都會使用 NTSTATUS 類型來傳回值。 此外，驅動程式會在完成 IRP時，在 IRP的IO_STATUS_BLOCK結構中提供 NTSTATUS 類型的值。 NTSTATUS 類型定義于 Ntdef.h 中，而系統提供的狀態碼定義于 Ntstatus.h 中。 (廠商也可以定義私人狀態碼，雖然它們很少需要。如需詳細資訊，請參閱 定義新的 NTSTATUS 值。)

NTSTATUS 值分成四種類型：成功值、參考值、警告和錯誤值。

系統會將許多值指派給每個類型。 測試從常式成功傳回時，常見的錯誤是比較常式的傳回值與STATUS_SUCCESS。 此比較只會檢查數個成功值的其中一個。

測試傳回值時，您應該使用 Ntdef.h) 中定義的下列其中一個系統提供的宏 (：

NT_SUCCESS (狀態)
如果Status所指定的傳回值是成功類型 (0 - 0x3FFFFFFF) 或資訊型別 (0x40000000 0x7FFFFFFF) ，則評估為TRUE。

NT_INFORMATION (狀態)
如果Status所指定的傳回值是資訊型別 (0x40000000 - 0x7FFFFFFF) ，評估為TRUE。

NT_WARNING (狀態)
如果Status所指定的傳回值是警告類型 (0x80000000 - 0xBFFFFFFF) ，評估為TRUE。

NT_ERROR (狀態)
如果Status所指定的傳回值是錯誤類型 (0xC0000000 -0xFFFFFFFF) ，評估為TRUE。

例如，假設驅動程式呼叫 IoRegisterDeviceInterface 來註冊裝置介面。 如果驅動程式使用 NT_SUCCESS 宏檢查傳回值，則如果常式傳回STATUS_SUCCESS，表示沒有錯誤，或傳回參考狀態STATUS_OBJECT_NAME_EXISTS，則宏會評估為 TRUE ，這表示裝置介面已註冊。

另一個範例是，假設驅動程式呼叫 ZwEnumerateKey 來列舉指定登錄機碼的子機碼。 如果NT_SUCCESS宏評估為 FALSE，可能是因為常式傳回STATUS_INVALID_PARAMETER，也就是錯誤碼，或因為常式傳回STATUS_NO_MORE_ENTRIES，也就是警告碼。

最後一個範例是，假設驅動程式會傳送 IRP，讓較低層級的驅動程式從裝置讀取資訊。 如果要求驅動程式指定的緩衝區太小而無法接收任何資訊，則較低層級驅動程式可能會傳回STATUS_BUFFER_TOO_SMALL來回應，這是錯誤碼。 如果第一個驅動程式指定可接收部分但並非所有要求資訊的緩衝區，則較低層級驅動程式可能會藉由提供盡可能的資料來回應，然後傳回STATUS_BUFFER_OVERFLOW，這是警告碼。 請注意，如果第一個驅動程式使用NT_SUCCESS或NT_ERROR不正確測試狀態值，它可能會不小心捨棄收到的部分資訊。