PSD_INSTALL

PSD_INSTALL keywords

Required, Can Block

Description
Determine if the PSD supports the current platform.

This function probes the hardware to see if the PSD supports the current platform. No other operations should be executed in this function. It is merely a presence check. This function is the first function called upon loading a PSD. It must store away all the information passed to it in the install structure.

Mode
Called in Init Mode; may be called in Kernel Mode.

Entry
Pointer to an INSTALL structure.

Exit

NO_ERROR

if the PSD installed successfully.
-1
if the PSD does not support the current platform.
Structures

typedef struct install_s{
   P_F_2   pPSDHlpRouter;  (Input)
   char   *pParmString;    (Input)
   void   *pPSDPLMA;       (Input)
   ulong_t sizePLMA;       (Input)
} INSTALL;

pPSDHlpRouter

points to the PSD help router. Use the PSDHelp macro in PSD.H to access the PSD helps.
pParmString
points to any parameters specified in CONFIG.SYS after the PSD's name. If no parameters were specified this field is NULL.
pPSDPLMA
points to the PSD's processor local memory area. This area contains different physical memory at the same linear address across all processors. You can use the area to store variables such that each processor accesses unique values, but all the code references the same variables.
sizePLMA
is the total size of the PSD's PLMA in bytes.
Notes
This function may be called after OS/2 is finished with initialization by the DosTestPSD API; therefore, the PSD developer must be careful not to use any Init mode only PSD help's in this function.

---

[Back: PSD Functions]
[Next: PSD_DEINSTALL]