Funkce zpětného volání stránky vlastností

Když poskytovatel vytvoří stránku vlastností pro své zařízení nebo třídu zařízení, poskytuje ukazatel na funkci zpětného volání. Funkce zpětného volání se volá jedenkrát, když je stránka vlastností vytvořena, a znovu, když se stránka chystá zničit.

Funkce callback je PropSheetPageProc, která je popsána v dokumentaci Windows SDK. Tato funkce musí být schopná zpracovat akce PSPCB_CREATE a PSPCB_RELEASE.

Zpětné volání se volá se zprávou PSPCB_CREATE při vytváření stránky vlastností. V reakci na tuto zprávu může zpětné volání přidělit paměť pro data přidružená ke stránce. Funkce by měla vrátit TRUE pro pokračování ve vytváření stránky nebo FALSE, pokud by stránka neměla být vytvořena.

Stránky vlastností zařízení jsou zničeny, když uživatel klikne na TLAČÍTKO OK nebo Zrušit v dialogovém okně stránky nebo klikne na Tlačítko Odinstalovat na kartě Ovladače .

Když dojde ke zničení stránky vlastností, volá se zpětné volání se zprávou PSPCB_RELEASE. Funkce by měla uvolnit všechna data, která byla přidělena při vytvoření stránky vlastností. Obvykle to zahrnuje uvolnění dat referencovaných členem lParam struktury PROPSHEETPAGE. Při likvidaci stránky se vrácená hodnota ignoruje.