WdfObjectReferenceActual 函数 （wdfobject.h）
[适用于 KMDF 和 UMDF]
WdfObjectReferenceActual 方法递增指定框架对象的引用计数，并将标记值、行号和文件名分配给引用。
语法
void WdfObjectReferenceActual(
[in] WDFOBJECT Handle,
[in, optional] PVOID Tag,
[in] LONG Line,
[in] PCCH File
);
参数
[in] Handle
框架对象的句柄。
[in, optional] Tag
框架存储为对象引用的标识标记的驱动程序定义值。
[in] Line
表示驱动程序源文件中的行号的数值。
[in] File
指向以 null 结尾的常量字符串的指针，该字符串表示驱动程序源文件的名称。 此参数是可选的，可以 NULL。
返回值
没有
注解
如果驱动程序提供无效的对象句柄，则会发生 bug 检查。
如果驱动程序 WdfObjectReferenceActual 来递增引用计数，驱动程序必须调用 WdfObjectDereferenceActual 以递减计数。
调用 WdfObjectReferenceActual 或 WdfObjectReferenceWithTag 而不是 WdfObjectReference 可提供Microsoft调试器的其他信息（标记值、行号和文件名）。 WdfObjectReferenceActual 允许驱动程序指定行号和文件名，而 WdfObjectReferenceWithTag 使用驱动程序的当前行号和文件名。
可以使用 ！wdftagtracker 调试器扩展来查看标记、行号和文件名值。 调试器扩展将标记值显示为指针和一系列字符。 有关调试器扩展的详细信息，请参阅 调试 KMDF 驱动程序。
有关对象引用计数的详细信息，请参阅 Framework 对象生命周期。
有关框架对象层次结构的清理规则的详细信息，请参阅 Framework 对象生命周期。
例子
下面的代码示例递增对象的引用计数，并将标记值、行号和文件名分配给引用。
WdfObjectReferenceActual(
object,
pTag,
line,
FILE_NAME
);
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 标头 | wdfobject.h （包括 Wdf.h） |
| 图书馆 | Wdf01000.sys（KMDF）：WUDFx02000.dll （UMDF） |
| IRQL | <=DISPATCH_LEVEL |
| DDI 符合性规则 | DriverCreate（kmdf） |