Fonction de rappel de page de propriétés

Lorsqu’un fournisseur crée une page de propriétés pour son appareil ou sa classe d’appareil, il fournit un pointeur vers une fonction de rappel. La fonction de rappel est appelée une fois lorsque la page de propriétés est créée et à nouveau quand elle est sur le point d’être détruite.

Le rappel est une fonction PropSheetPageProc décrite dans la documentation du Kit de développement logiciel (SDK) Windows. Cette fonction doit être en mesure de gérer les actions PSPCB_CREATE et PSPCB_RELEASE.

Le rappel est appelé avec un message PSPCB_CREATE lors de la création d’une page de propriétés. En réponse à ce message, le rappel peut allouer de la mémoire aux données associées à la page. La fonction doit retourner TRUE pour continuer à créer la page ou FALSE si la page ne doit pas être créée.

Les pages de propriétés d’un appareil sont détruites lorsque l’utilisateur clique sur OK ou Sur Annuler dans la boîte de dialogue de la page ou sur Désinstaller sous l’onglet Pilotes .

Lorsqu’une page de propriétés est détruite, le rappel est appelé avec un message PSPCB_RELEASE. La fonction doit libérer toutes les données qui ont été allouées lors de la création de la page de propriétés. En règle générale, cela implique de libérer les données référencées par le membre lParam de la structure PROPSHEETPAGE. La valeur de retour est ignorée lors de la destruction de la page.