Compartilhar via


XXX_Open (Device Manager)

Windows Mobile Not SupportedWindows Embedded CE Supported

9/8/2008

Essa função abrirá um dispositivo para ler, gravar ou ambos. Um aplicativo indiretamente chama essa função quando ele chama o CreateFile função para aberto nomes arquivo dispositivo especial.

Syntax

DWORD XXX_Open(
  DWORD hDeviceContext,
  DWORD AccessCode,
  DWORD ShareMode 
);

Parameters

  • hDeviceContext
    [no] Identificador para o contexto dispositivo. O XXX_Init (Device Manager) função Cria e retorna esse identificador.
  • AccessCode
    [no] Codificar o acesso para o dispositivo. A acessar é uma combinação de ler e acesso de gravação de CreateFile.
  • ShareMode
    [no] Modo compartilhar arquivos do dispositivo. O modo compartilhar é uma combinação de ler e acesso de gravação o compartilhamento do CreateFile.

Return Value

Essa função retorna um identificador que identifica o aberto contexto do dispositivo para o aplicativo chamado. Se seu dispositivo pode ser aberto múltiplo horários, use este identificador para identificar cada aberto contexto. Esse identificador é passada para o XXX_Read (Device Manager), XXX_Write (Device Manager), XXX_Seek (Device Manager), e XXX_IOControl (Device Manager) funções. Essa função retorna zero se o dispositivo não pode ser aberto.

Remarks

Quando esta função executa, seu dispositivo deve alocar os recursos que ele precisa para cada aberto contexto e preparar para operação. Isso pode envolver Preparando o dispositivo para leitura ou gravação e ao inicializar estruturas dados que ele usa para operação.

Device Manager usa o XXX prefixo. Ao implementar a interface transmitir, substituir XXX Com um prefixo apropriado para sua implementação ou não decorado usar nomes ponto de entrada em conjunto com DEVFLAGS_NAKEDENTRIES. Para obter mais informações sobre outros válido Sinalizadores valores, consulte ActivateDeviceEx.

Requirements

Header Developer Implemented
Library Developer Implemented
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

ActivateDeviceEx
XXX_Init (Device Manager)
XXX_IOControl (Device Manager)
XXX_Read (Device Manager)
XXX_Seek (Device Manager)
XXX_Write (Device Manager)

Concepts

Device File Names

Other Resources

CreateFile