PSD_INSTALL

PSD_INSTALL keywords

Required, Can Block

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.

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

Pointer to an INSTALL structure.

if the PSD installed successfully.

if the PSD does not support the current platform.

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

points to the PSD help router. Use the PSDHelp macro in PSD.H to access the PSD helps.

points to any parameters specified in CONFIG.SYS after the PSD's name. If no parameters were specified this field is NULL.

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.

is the total size of the PSD's PLMA in bytes.

This function may be called after OS/2 is finished with initialization by the Dos32TestPSD API; therefore, the PSD developer must be careful not to use any Init mode only PSD help's in this function.