Função WdfDeviceGetHardwareRegisterMappedAddress (wdfdevice.h)

  • Artigo

[Aplica-se somente ao UMDF]

Um driver chama WdfDeviceGetHardwareRegisterMappedAddress para obter o endereço mapeado no modo de usuário do recurso de memória mapeado anteriormente usando WdfDeviceMapIoSpace.

Sintaxe

PVOID WdfDeviceGetHardwareRegisterMappedAddress(
  [in] WDFDEVICE Device,
  [in] PVOID     PseudoBaseAddress
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] PseudoBaseAddress

O endereço de um local que recebe um ponteiro para o endereço pseudo-base.

Retornar valor

Endereço base do modo de usuário dos recursos mapeados anteriormente usando WdfDeviceMapIoSpace.

Comentários

Essa função é o equivalente a UMDF versão 2 de IWDFDevice3::GetHardwareRegisterMappedAddress.

Depois que o driver chama WdfDeviceGetHardwareRegisterMappedAddress, ele pode acessar o endereço do modo de usuário diretamente para ler e gravar no registro.

Nota Essa não é a abordagem recomendada para acessar registros porque impede que o UMDF faça qualquer validação no acesso.
 

Se você usar WdfDeviceGetHardwareRegisterMappedAddress, deverá definir a diretiva INF UmdfRegisterAccessMode como RegisterAccessUsingUserModeMapping. Para obter mais informações sobre diretivas INF UMDF, consulte Especificando diretivas WDF em arquivos INF.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1
Plataforma de Destino Universal
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

Confira também

IWDFDevice3::GetHardwareRegisterMappedAddress

WdfDeviceMapIoSpace