Función IoGetDriverProxyExtensionFromDriverObject (wdm.h)

La función IoGetDriverProxyExtensionFromDriverObject recupera la extensión DriverProxy que pertenece al objeto de controlador especificado.

Syntax

PDRIVER_PROXY_EXTENSION IoGetDriverProxyExtensionFromDriverObject(
  PDRIVER_OBJECT DriverObject
);

Parámetros

DriverObject

[in] Puntero a la DRIVER_OBJECT que posee la extensión DriverProxy que se va a recuperar.

Valor devuelto

IoGetDriverProxyExtensionFromDriverObject devuelve un puntero a la extensión DriverProxy propiedad del objeto de controlador especificado o NULL si el objeto driver no tiene una extensión DriverProxy asociada.

Observaciones

Esta función proporciona una manera sencilla de recuperar una extensión DriverProxy existente que se creó anteriormente con IoCreateDriverProxyExtension y asociada a un objeto de controlador, sin necesidad de almacenar el puntero de extensión por separado. La función se usa normalmente cuando un controlador necesita tener acceso a su extensión DriverProxy desde diferentes partes de su código.

Se puede llamar a la función en cualquier nivel irQL y no realiza ninguna asignación de memoria ni operaciones complejas.

Si el campo DriverExtension del objeto de controlador es NULL, la función devolverá NULL y puede desencadenar una aserción en compilaciones de depuración.

Requisitos

Consulte también

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints

DRIVER_OBJECT