RegisterDevice
9/8/2008
Essa função registra um dispositivo.
Observação
Essa função é obsoleto. Use ActivateDeviceEx.
Observação
Essa função é obsoleto as of Windows Embedded CE 6.0. Use ActivateDeviceEx.
Syntax
HANDLE RegisterDevice(
LPCWSTR lpszType,
DWORD dwIndex,
LPCWSTR lpszLib,
DWORD dwInfo
);
Parameters
- lpszType
[no] Ponteiro longo para o seqüência de caracteres NULL-Terminated que contém o prefixo identificador dispositivo, de exemplo COM, Dev ou PGR. Deve ter três caracteres.
- dwIndex
[no] Índice identificador do dispositivo. Deve ser um número de 0 (zero) a 9. De exemplo, o valor índice para a COM2 é 2.
- lpszLib
[no] Ponteiro longo para o seqüência de caracteres NULL-Terminated que identifica o nome DLL driver de dispositivo.
- dwInfo
[no] Informações de instância.
Return Value
Para todas as plataformas
Um identificador para um dispositivo indica sucesso. Zero indica falha
Para dispositivos que expõem a interface transmitir, os drivers são arquivos DLL. O RegisterDevice função inicializa cada driver. O Device Manager chama essa função on Behalf Of o driver. No entanto, aplicativos pode carregar personalizado transmitir interfaces, no qual maiúsculas e minúsculas eles também chamar esta função para registrar o driver. O lpszLib parâmetro abre o dispositivo. O lpszType parâmetro é um três - seqüência de caracteres que identifica entrada a função aponta na DLL assim que múltiplo dispositivos podem existir em um DLL. O lpszLib parâmetro é o nome de DLL que contém os pontos de entrada. Passar a dwInfo parâmetro para rotina de inicialização.
Para Windows incorporado CE
Esse identificador é obtido de função XXX_Init (Device Manager) do driver e é passada para o XXX_Open (Device Manager), XXX_Deinit (Device Manager)XXX_PowerUp (Device Manager)e XXX_PowerDown (Device Manager) funções.
Remarks
Use a função DeregisterDevice, se o usuário remove um dispositivo de sistema ou se o sistema está sendo desligado e se o identificador foi retornado de um chamar para RegisterDevice.
Esta função só é que pode ser chamado por chamadores privilegiados. A seguinte lista mostra as ramificações disso:
- O instalador para o driver deve usar um caminho relativo para o DLL. O caminho relativo deve apontar para o diretório do Windows ou outros locais no caminho de pesquisa especificado.
- Se o instalador usa um caminho explícito, é responsável por configuração podem modificar o caminho correto e não apontar para um Diretório que codificar normal.
Requirements
Header | winbase.h |
Library | coredll.lib |
Windows Embedded CE | Windows CE 1.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
Device Manager Functions
ActivateDeviceEx
DeregisterDevice
XXX_Deinit (Device Manager)
XXX_Init (Device Manager)
XXX_Open (Device Manager)
XXX_PowerDown (Device Manager)
XXX_PowerUp (Device Manager)