XXX_IOControl (Device Manager)

9/8/2008

Essa função envia um comando para um dispositivo.

Syntax

BOOL XXX_IOControl(
  DWORD hOpenContext,
  DWORD dwCode,
  PBYTE pBufIn,
  DWORD dwLenIn,
  PBYTE pBufOut,
  DWORD dwLenOut,
  PDWORD pdwActualOut 
);

Parameters

• hOpenContext
  [no] Identificador para o aberto contexto do dispositivo. O XXX_Open (Device Manager) função Cria e retorna esse identificador.

• dwCode
  [no] Operação controle E/S para executar. Esses códigos são específicas do dispositivo e geralmente estão expostos aos desenvolvedores a um arquivo cabeçalho.

• pBufIn
  [no] Ponteiro para a reserva contendo dados para transferir para o dispositivo.

• dwLenIn
  [no] Número de bytes de dados na reserva especificada para pBufIn.

• pBufOut
  [out] Ponteiro para a reserva usado para transferir dados de saída a partir de dispositivo.

• dwLenOut
  [no] Número máximo de bytes na reserva especificada por pBufOut.

• pdwActualOut
  [out] Ponteiro para o DWORD reserva que essa função usa para retornar o real número de bytes recebidos a partir de dispositivo.

Return Value

TRUE indica sucesso. FALSE indica falha.

Remarks

Um aplicativo usa o DeviceIoControl função para especificar uma operação para executar. O sistema operacional, por sua vez, chama o XXX_IOControl função. O dwCode parâmetro contém a entrada ou saída operação para executar; Esses códigos são geralmente específicos para cada driver de dispositivo e estão expostos aos programadores aplicativo por um arquivo cabeçalho que faz o desenvolvedor driver de dispositivo disponível.

Se você definir a HKEY_LOCAL_MACHINE\Drivers\BuiltIn\MyDevice\Ioctl chave Registro para o driver de dispositivo, Device Manager invoca o XXX_IOControl função quando ele carrega e inicializa o driver de dispositivo. Ele usa o IOCTL valor do Registro para a dwCode parâmetro e NULL para a pBufIn e pBufOut Parâmetros. Seu dispositivo pode usar esta opção para carregar outros módulos que exigem a instalação do driver de dispositivo básico, ou como um disparador para executar outras ações que não são adequadas à parte de XXX_Init (Device Manager) função. A seqüência de chamadas feitas a um driver de dispositivo nesse cenário é real XXX_Init, XXX_Open, XXX_IOControl, e XXX_Close (Device Manager). O XXX_Open chamar função é necessária para Device Manager para recuperar um válido identificador contexto e o XXX_Fechar função é necessária para deixar o driver de dispositivo disponível para servir aplicativos.

Device Manager usa o XXX prefixo. Ao implementar a interface transmitir, substituir XXX Com um prefixo apropriado para sua implementação específica 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.

Se possível, implementar todas energia gerenciamento IOCTLs no seu driver.

Requirements

See Also

Reference

ActivateDeviceEx
DeviceIoControl
XXX_Close (Device Manager)
XXX_Init (Device Manager)
XXX_Open (Device Manager)

Other Resources

Device Manager
Power Management I/O Controls
IOCTL_PSL_NOTIFY