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

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

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

O retorno de chamada é chamado com uma mensagem PSPCB_CREATE quando uma página de propriedades está sendo criada. Em resposta a essa mensagem, o retorno de chamada pode alocar memória para dados 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 Cancelar na caixa de diálogo da página ou clica em Desinstalar na guia Drivers .

Quando uma página de propriedades é destruída, o retorno de chamada é chamado com uma mensagem PSPCB_RELEASE. A função deve liberar todos os dados alocados quando a página de propriedades 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.