IoGetDriverProxyExtensionFromDriverObject 函数 (wdm.h)

IoGetDriverProxyExtensionFromDriverObject 函数检索由指定驱动程序对象拥有的 DriverProxy 扩展。

Syntax

PDRIVER_PROXY_EXTENSION IoGetDriverProxyExtensionFromDriverObject(
  PDRIVER_OBJECT DriverObject
);

参数

DriverObject

[in]指向拥有要检索的 DriverProxy 扩展 的DRIVER_OBJECT 的指针。

返回值

IoGetDriverProxyExtensionFromDriverObject 返回指向指定驱动程序对象拥有的 DriverProxy 扩展的指针,如果驱动程序对象没有关联的 DriverProxy 扩展,则返回 NULL。

注解

此函数提供了一种简单的方法来检索以前使用 IoCreateDriverProxyExtension 创建的现有 DriverProxy 扩展,并与驱动程序对象关联,而无需单独存储扩展指针。 当驱动程序需要从其代码的不同部分访问其 DriverProxy 扩展时,通常会使用该函数。

可以在任何 IRQL 级别调用该函数,并且不执行任何内存分配或复杂作。

如果驱动程序对象的 DriverExtension 字段为 NULL,则该函数将返回 NULL,并可能在调试生成中触发断言。

要求

Requirement 价值
目标平台 普遍
Header wdm.h
Library NtosKrnl.lib
IRQL 任何级别

另请参阅

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints

DRIVER_OBJECT