Compartilhar via


RegisterDevice

Windows Mobile SupportedWindows Embedded CE Supported

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

Aa910315.collapse(pt-BR,WinEmbedded.60).gif 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.

Aa910315.collapse(pt-BR,WinEmbedded.60).gif 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)

Other Resources

Stream Interface Drivers