Função IoGetDriverProxyExtensionFromDriverObject (wdm.h)

A função IoGetDriverProxyExtensionFromDriverObject recupera a extensão DriverProxy que pertence ao objeto driver especificado.

Sintaxe

PDRIVER_PROXY_EXTENSION IoGetDriverProxyExtensionFromDriverObject(
  PDRIVER_OBJECT DriverObject
);

Parâmetros

DriverObject

[in] Um ponteiro para o DRIVER_OBJECT que possui a extensão DriverProxy a ser recuperada.

Valor de retorno

IoGetDriverProxyExtensionFromDriverObject retorna um ponteiro para a extensão DriverProxy de propriedade do objeto driver especificado ou NULL se o objeto driver não tiver uma extensão DriverProxy associada.

Observações

Essa função fornece uma maneira simples de recuperar uma extensão DriverProxy existente que foi criada anteriormente com IoCreateDriverProxyExtension e associada a um objeto de driver, sem a necessidade de armazenar o ponteiro de extensão separadamente. A função geralmente é usada quando um driver precisa acessar sua extensão DriverProxy de diferentes partes de seu código.

A função pode ser chamada em qualquer nível de IRQL e não executa nenhuma alocação de memória ou operações complexas.

Se o campo DriverExtension do objeto driver for NULL, a função retornará NULL e poderá disparar uma declaração em builds de depuração.

Requirements

Consulte também

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints

DRIVER_OBJECT