Device File Names
.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.")
.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
Os aplicativos podem acessar dispositivos periféricos através de funções sistema de arquivos, como CreateFile. As arquivo E/S operações são redirecionadas para a interface transmitir.
A seguinte tabela mostra as descrições e exemplos para os dispositivo três espaços para nome.
| Descrição namespace | Exemplo |
|---|---|
Prefixo três letra, seguido por um número entre 0 e 9, seguido por um dois-pontos. |
" LPT2: " |
barramento $ montar apontar, seguido pelo barramento nome, número barramento, número dispositivo e função número. |
"\$bus\PCMCIA_0_0_0" |
apontar de montagem dispositivo $, seguido por um prefixo três letra que representa o dispositivo, seguido por um número. |
"\$device\COM7" |
O exemplo, COM7 é dispositivo 0, função 0 no barramento PCMCIA 0. CreateFile podem aceitar qualquer um desses nomes. Cada espaço nome retorna alças com propriedades diferentes.
Os espaços para nome que contenha montagem suporte pontos mais de 10 ocorrências de um dispositivo com o mesmo prefixo três letra. De exemplo, COM23 pode representar porta serial 23.
Prefixos Nome do arquivo de dispositivo
O prefixo do nome arquivo dispositivo consiste maiúscula três letras que identificam qual nome arquivo dispositivo corresponde a uma interface específica transmitir. Quando você implementar a interface transmitir, você designar os três-prefixo letra. O prefixo pode ser qualquer três letras, embora você deva usar um comum prefixo se seu driver é a mesma classe de dispositivo como outros drivers. De exemplo, os drivers para serial dispositivos, como modems, poderia usar o comum prefixo COM, embora outros drivers já esteja usando esse prefixo. O driver pode distinguir próprio de outros drivers usando um índice diferente.
O prefixo serve dois propósitos. Primeiro, o prefixo identifica todos os nomes arquivo dispositivo possíveis que podem acessar o driver interface transmitir. Em segundo lugar, o prefixo informa o sistema operacional que entrada-arquivo apontar nomes para esperado na interface de transmitir DLL. De exemplo, para implementar um driver de dispositivo para um pager PC Card, você pode escolher PGR como a três - prefixo letra, que por sua vez, seria ditar entrada - apontar nomes, como PGR_Init, PGR_IOControl, e assim por diante.
O prefixo é armazenado em um chamado valor do Registro Prefixo, que está localizado dentro de chave para o driver. Geralmente, o utilitário instalação que instala um driver cria este valor do Registro, along with outros valores que o driver precisa. Se a pasta Prefixo subchave não existe, e deve haver inicialização e pontos entrada de-Initialization.
Índices Nome do arquivo de dispositivo
O índice diferencia dispositivos semelhantes que gerencia a interface transmitir. O índice é o dígito que segue o prefixo. Por padrão, Device Manager índices logicamente de 1 a 9, com 1 correspondente ao nome do arquivo primeiro dispositivo. Se você precisar um décimo nome arquivo dispositivo, use 0 como o índice.
Se você deve número seus nomes arquivo dispositivo começando um índice Other Than 1, especificar um índice inicial em um chamado valor do Registro O índice Dentro de chave do Registro para seu driver. Isso geralmente é necessário se o driver interface transmitir serve um dispositivo que deve usar um comum prefixo, such as COM. De exemplo, COM1:, COM2: e COM3: Geralmente corresponder ao interno hardware porta serial. Se o driver for para um serial dispositivo, such as um modem Packet-Radio, ela deve aparecer como um porta COM como modem software geralmente pressupõe que os modems estão conectados a portas COM. Você pode especificar um O índice valor de 4 para diferenciar seu serial dispositivo daquelas que estão compilado para o hardware.
Se você especificar O índice, em vez de índices atribuir Device Manager, Por padrão, permitindo que o driver será suporte somente um dispositivo como Device Manager pode registrar nome arquivo apenas um dispositivo. Se você precisará especificar O índice Mas é necessário o nome arquivo mais de um dispositivo, você tem duas opções. A função inicialização pode registrar nomes arquivo dispositivo adicional com o ActivateDeviceEx função, ou o utilitário instalação pode criar conjuntos adicionais de Registro chaves, cada qual com um índice diferente, quando o driver está instalado.
Identificador de Dispositivo e arquivo identificador de operações
Acessos aos drivers dispositivo no dispositivo $ e $ barramento espaços para nome são automaticamente roteadas para o CreateFile ponto de entrada registrado com RegisterAFSEx.
Alças de dispositivo permitem direcionar as solicitações para o driver barramento. De exemplo, um aplicativo painel de controle pode desejar para descarregar um driver de dispositivo ou forçar o driver barramento para renumerar os dispositivos filho.
Chamadas para CreateFile** Implicitamente do chamar o driver de dispositivo XXX_Open (Device Manager) função. Device Manager pode notificar o driver que um determinado identificador será usado para dispositivo-nível operações adicionando um bit de máscara direitos acessar passada para do o driver XXX_Init (Device Manager) função. Este bit for adicionado com base no espaço para nome usado para o identificador aberto e não pode ser um dos parâmetros para CreateFile. Para referência, o driver pode associar o bit acessar com o aberto dados ele retorna do seu XXX_Open função ao processamento outras APIs. **
A seguinte tabela mostra como obter um identificador dispositivo ou um identificador de arquivo.
| Primeiro parâmetro para CreateFile | Descrição |
|---|---|
" COM7: " |
Retorna um identificador de arquivo normal para o dispositivo. Este é o herdado convenção de nomenclatura. |
"\$device\COM7" |
Retorna um identificador de arquivo Normal, que pode ser para um dispositivo que não pode ser nomeado usando o herdado convenção de nomenclatura. |
"\$bus\PCMCIA_0_0_0" |
Retorna um identificador dispositivo ao dispositivo 0, função 0 no barramento PCMCIA 0. Embora esse identificador pode ser manipulado usando o APIs mesmo como um identificador de arquivo normal, as operações permite que podem ser diferentes e acessar para essas alças pode ser protegido de forma diferente pela OS. |
Todos os caminhos três dispositivo podem ser implementados pelo mesmo driver. Caminhos 1 e 2 são equivalente. Caminho 3 pode ser usado para gerenciamento de energia, mas não para o tráfego dados.
A determinação de suporte do identificador de dispositivo
O apropriado método para determinar qual suporte dispositivos o novo identificador é dependem anunciado interfaces. Um driver barramento pode anunciar um GUID especificado para indicar que o driver barramento oferece suporte a drivers descarregando e reloading. Um driver barramento também pode anunciar outro GUID para indicar que o driver barramento oferece suporte ao gerenciamento de energia em dispositivos filho. Da mesma forma, um novo GUID pode indicar que IOCTLs o gerenciador de energia deve usar alças dispositivo.
See Also
Reference
Concepts
Device Interfaces
Resolving Race Conditions in Device Drivers