学步园

在Windows驱动程序的编写中，当我们调用一个返回NTSTATUS值的函数时（比如IoCreateDevice），应当检查返回值是否成功。

有人经常这样写

ntStatus = function(...);<br /> if(STATUS_SUCCESS == ntStatus)<br /> ...

但是，这并不总是合理的。

在ddk头文件”ntdef.h“中，NTSTATUS是这样定义的：

typedef __success(return >= 0) LONG NTSTATUS;<br /> //<br /> // Status values are 32 bit values layed out as follows:<br /> //<br /> // 3 3 2 2 2 2 2 2 2 2 2 2 1 1 1 1 1 1 1 1 1 1<br /> // 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0<br /> // +---+-+-------------------------+-------------------------------+<br /> // |Sev|C| Facility | Code |<br /> // +---+-+-------------------------+-------------------------------+<br /> //<br /> // where<br /> //<br /> // Sev - is the severity code<br /> //<br /> // 00 - Success<br /> // 01 - Informational<br /> // 10 - Warning<br /> // 11 - Error<br /> //<br /> // C - is the Customer code flag<br /> //<br /> // Facility - is the facility code<br /> //<br /> // Code - is the facility's status code<br /> // 

可见，NTSTATUS是一个有符号
的长整数。并且分为四个域。最高2位Sev域，描述的是这个NTSTATUS的严重性（Severity）：

00 成功（Success）

01 信息（Informational）

10 警告（Warning）

11 错误（Error）

00和01应该都表示成功的状态，10和11都表示错误状态。即对于这样的有符号长整数的最高位（也就是符号位）
，0成功，1错误。那么，如果NTSTATUS>=0为成功，NTSTATUS<0为错误。

因此，在头文件”ntdef.h“中，测试NTSTATUS成功的宏定义为：

#define NT_SUCCESS(Status) (((NTSTATUS)(Status)) >= 0)<br />

而不是我以前想象的测试status == 0（STATUS_SUCCESS = 0）

参考我在StackOverflow上发的问题，感谢解答问题的老外^_^

http://stackoverflow.com/questions/3378622/how-to-understand-the-ntstatus-nt-success-typedef-in-windows-ddk/3378675