PSD INSTALL

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.

Syntax

PSD_INSTALL '''keywords''' Required, Can Block

Parameters

Structure

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.

Remarks

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.