Rückruffunktion für Eigenschaftenseiten

Wenn ein Anbieter eine Eigenschaftenseite für sein Gerät oder seine Geräteklasse erstellt, stellt er einen Zeiger auf eine Rückruffunktion bereit. Die Rückruffunktion wird einmal aufgerufen, wenn die Eigenschaftenseite erstellt wird, und erneut, wenn sie zerstört werden soll.

Der Rückruf ist eine PropSheetPageProc-Funktion , die in der Windows SDK-Dokumentation beschrieben wird. Diese Funktion muss in der Lage sein, die PSPCB_CREATE und PSPCB_RELEASE Aktionen zu verarbeiten.

Der Rückruf wird mit einer PSPCB_CREATE-Meldung aufgerufen, wenn eine Eigenschaftenseite erstellt wird. Als Reaktion auf diese Meldung kann der Rückruf Speicher für Daten zuweisen, die der Seite zugeordnet sind. Die Funktion sollte TRUE zurückgeben, um mit der Erstellung der Seite fortzufahren, oder FALSE , wenn die Seite nicht erstellt werden soll.

Eigenschaftenseiten für ein Gerät werden zerstört, wenn der Benutzer im Dialogfeld der Seite auf OK oder Abbrechen klickt oder auf der Registerkarte Treiber auf Deinstallieren klickt.

Wenn eine Eigenschaftenseite zerstört wird, wird der Rückruf mit einer PSPCB_RELEASE-Nachricht aufgerufen. Die Funktion sollte alle Daten freigeben, die beim Erstellen der Eigenschaftenseite zugeordnet wurden. In der Regel umfasst dies das Freigeben der Daten, auf die vom lParam-Element der PROPSHEETPAGE-Struktur verwiesen wird. Der Rückgabewert wird ignoriert, wenn die Seite zerstört wird.