Función de devolución de llamada de página de propiedades

Cuando un proveedor crea una página de propiedades para su clase de dispositivo o dispositivo, proporciona un puntero a una función de devolución de llamada. Se llama a la función de devolución de llamada una vez cuando se crea la página de propiedades y de nuevo cuando está a punto de destruirse.

La devolución de llamada es una función PropSheetPageProc que se describe en la documentación de Windows SDK. Esta función debe ser capaz de controlar las acciones de PSPCB_CREATE y PSPCB_RELEASE.

Se llama a la devolución de llamada con un mensaje de PSPCB_CREATE cuando se crea una página de propiedades. En respuesta a este mensaje, la devolución de llamada puede asignar memoria para los datos asociados a la página. La función debe devolver TRUE para seguir creando la página o FALSE si no se debe crear la página.

Las páginas de propiedades de un dispositivo se destruyen cuando el usuario hace clic en Aceptar o Cancelar en el cuadro de diálogo de la página o hace clic en Desinstalar en la pestaña Controladores .

Cuando se destruye una página de propiedades, se llama a la devolución de llamada con un mensaje PSPCB_RELEASE. La función debe liberar los datos que se asignaron cuando se creó la página de propiedades. Normalmente, esto implica liberar los datos a los que hace referencia el miembro lParam de la estructura PROPSHEETPAGE. El valor devuelto se omite cuando se destruye la página.