XXX_Open (Device Manager)
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
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)