Função de retorno de chamada da página de configuração

Quando um provedor cria uma página de propriedade para seu dispositivo ou classe de dispositivo, ele fornece um ponteiro para uma função callback. A função de retorno de chamada é acionada uma vez quando a página de propriedade é criada e novamente quando está prestes a ser destruída.

A callback é uma função PropSheetPageProc descrita na documentação do SDK do Windows. Essa função deve ser capaz de lidar com as ações PSPCB_CREATE e PSPCB_RELEASE.

A callback é chamada com uma mensagem PSPCB_CREATE quando uma página de propriedade está sendo criada. Em resposta a essa mensagem, a função de retorno de chamada pode alocar memória para dados que estão associados à página. A função deve retornar TRUE para continuar a criar a página ou FALSE se a página não deve ser criada.

As páginas de propriedades de um dispositivo são destruídas quando o usuário clica em OK ou Cancela na caixa de diálogo da página ou clica em Desinstalar na guia Drivers .

Quando uma página de propriedade é destruída, é feita uma chamada de retorno com uma mensagem PSPCB_RELEASE. A função deve liberar todos os dados que foram alocados quando a página de propriedade foi criada. Normalmente, isso envolve a liberação dos dados referenciados pelo membro lParam da estrutura PROPSHEETPAGE. O valor retornado é ignorado quando a página está sendo destruída.