estrutura SP_DETECTDEVICE_PARAMS (setupapi.h)

  • Artigo

Uma estrutura SP_DETECTDEVICE_PARAMS corresponde a uma solicitação de instalação DIF_DETECT.

Sintaxe

typedef struct _SP_DETECTDEVICE_PARAMS {
  SP_CLASSINSTALL_HEADER  ClassInstallHeader;
  PDETECT_PROGRESS_NOTIFY DetectProgressNotify;
  PVOID                   ProgressNotifyParam;
} SP_DETECTDEVICE_PARAMS, *PSP_DETECTDEVICE_PARAMS;

Membros

ClassInstallHeader

Um cabeçalho de solicitação de instalação que contém o tamanho do cabeçalho e o código DIF da solicitação. Consulte SP_CLASSINSTALL_HEADER.

DetectProgressNotify

Uma rotina de retorno de chamada que exibe uma barra de progresso para a operação de detecção de dispositivo. A rotina de retorno de chamada é fornecida pelo componente de instalação do dispositivo que envia a solicitação DIF_DETECT . O retorno de chamada tem o seguinte protótipo:

typedef BOOL (CALLBACK* PDETECT_PROGRESS_NOTIFY)(
    IN PVOID ProgressNotifyParam,
    IN DWORD DetectComplete
    );

ProgressNotifyParam é um "identificador" opaco que identifica a operação de detecção. Esse valor é fornecido pelo componente de instalação do dispositivo que enviou a solicitação DIF_DETECT.

DetectComplete é um valor entre 0 e 100 que indica a porcentagem de conclusão. O instalador de classe incrementa esse valor em vários estágios de suas atividades de detecção, para notificar o usuário sobre seu progresso.

ProgressNotifyParam

O " identificador" progressnotifyparam opaco que o instalador de classe passa para a rotina de retorno de chamada de progresso.

Requisitos

Requisito Valor
Cabeçalho setupapi.h (inclua Setupapi.h)

Confira também

DIF_DETECT

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller