Compartilhar via


ActivateDevice

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa função carrega um driver de dispositivo. Para funcionalidade adicional, use a função ActivateDeviceEx.

Syntax

HANDLE ActivateDevice(
  LPCWSTR lpszDevKey, 
  DWORD dwClientInfo
);

Parameters

  • lpszDevKey
    [no] Ponteiro para uma seqüência de caracteres que identifica a localidade sob a HKEY_LOCAL_MACHINE subárvore Registro onde o Driver subchave Registro para o dispositivo reside. Uma subchave Registro driver contém o nome dynamic-link library (DLL), dispositivo prefixo, nome amigável e outras informações dispositivo.
  • dwClientInfo
    [no] Dados para armazenar na Ativa subchave Registro para o dispositivo in a ClientInfo entrada Registro.

    O caminho Registro para a Ativa subchave Registro para o dispositivo é passado como o contexto parâmetro para função do dispositivo XXX_Init (Device Manager). Após o valor em dwClientInfo é armazenado no Registro em HKEY_LOCAL_MACHINE\Drivers\Active, as chamadas Device Manager XXX_Init. Devload.h define DEVLOAD_CLIENTINFO_VALNAME e DEVLOAD_CLIENTINFO_VALTYPE para acessar para facilitar a ClientInfo chave. **

Return Value

Retorna um identificador para o dispositivo que você pode usar em chamadas subseqüentes para a função DeactivateDevice, se bem-sucedido. Se a função não for bem-sucedido, ele retorna NULL. Para obter informações de erro estendidas, chamar GetLastError.

Remarks

ActivateDevice carrega um driver de dispositivo e lê o chave do Registro especificado em lpszDevKey Para get o nome DLL, dispositivo prefixo, índice e outros valores. Em seguida, ele adiciona o dispositivo para o ativo lista dispositivo in a HKEY_LOCAL_MACHINE\Drivers\Active chave Registro e armazena os valores relevantes existe. Se você não fizer isso especificar um índice na subchave Registro especificado no dispositivo lpszDevKey, em seguida, ActivateDevice Atribui um livre índice. Em seguida, ActivateDevice Carrega o driver de dispositivo DLL no espaço de processo da Device Manager. Finalmente, o Device Manager envia uma mensagem notificação dispositivo para o novo dispositivo. Para obter mais informações sobre dispositivo notificações, consulte Device Interface Notifications.

Se o OS inteiro deve reconhecer o driver e seus aplicativos devem carregar dispositivo Custom-Purpose drivers, use ActivateDevice.

Requirements

Header winbase.h
Library coredll.lib
Windows Embedded CE Windows CE 2.11 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ActivateDeviceEx
DeactivateDevice
RegisterDevice
XXX_Init (Device Manager)

Concepts

Device Interface Notifications