XXX_Open (Device Manager)

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

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