Callbackfunctie voor eigenschappen-pagina

Wanneer een provider een eigenschappenpagina voor het apparaat of de apparaatklasse maakt, wordt er een aanwijzer naar een callback-functie geleverd. De callback-functie wordt één keer aangeroepen wanneer de eigenschappenpagina wordt gemaakt en opnieuw wanneer deze op het punt staat te worden vernietigd.

De callback is een PropSheetPageProc-functie die wordt beschreven in de Windows SDK-documentatie. Deze functie moet de PSPCB_CREATE en PSPCB_RELEASE acties kunnen verwerken.

De callback wordt aangeroepen met een PSPCB_CREATE bericht wanneer er een eigenschappenpagina wordt gemaakt. Als reactie op dit bericht kan de callback geheugen toewijzen aan gegevens die aan de pagina zijn gekoppeld. De functie moet TRUE retourneren om door te gaan met het maken van de pagina of ONWAAR als de pagina niet mag worden gemaakt.

Eigenschappenpagina's voor een apparaat worden vernietigd wanneer de gebruiker op OK of Annuleren klikt in het dialoogvenster van de pagina of op Verwijderen op het tabblad Stuurprogramma's .

Wanneer een eigenschappenpagina wordt vernietigd, wordt de callback aangeroepen met een PSPCB_RELEASE bericht. De functie moet gegevens vrijmaken die zijn toegewezen toen de eigenschappenpagina werd gemaakt. Dit omvat doorgaans het vrijmaken van de gegevens waarnaar wordt verwezen door het lid lParam van de PROPSHEETPAGE-structuur. De retourwaarde wordt genegeerd wanneer de pagina wordt vernietigd.