StorPortEnablePassiveInitialization routine

The StorPortEnablePassiveInitialization routine enables the miniport's HwStorPassiveInitializeRoutine callback routine to execute at PASSIVE_LEVEL during miniport initialization.

Syntax


BOOLEAN StorPortEnablePassiveInitialization(
  _In_ PVOID                          HwDeviceExtension,
  _In_ PHW_PASSIVE_INITIALIZE_ROUTINE HwPassiveInitialization
);

Parameters

HwDeviceExtension [in]

Pointer to the per-adapter device extension.

HwPassiveInitialization [in]

Pointer to a callback routine that the port driver calls at PASSIVE_LEVEL to initialize the DPCs that the miniport driver will use. For a description of this callback routine, see HwStorPassiveInitializeRoutine.

Return value

The StorPortEnablePassiveInitialization routine returns TRUE if the operating system supports DPCs, and FALSE if not.

Remarks

A miniport must call the StorPortEnablePassiveInitialization routine only from within HwStorInitialize. Otherwise, StorPortEnablePassiveInitialization will return FALSE and the HwStorPassiveInitializeRoutine routine will not execute.

This routine is implemented using inline function definitions, so that miniport drivers that use this routine will not have to link to libraries that are dependent on the version of the operating system. Miniport drivers can use this routine without sacrificing backward compatibility with versions of the operating system that do not support DPCs in storage miniport drivers.

Requirements

Target platform

Desktop

Header

Storport.h (include Storport.h)

IRQL

DIRQL

DDI compliance rules

StorPortEnablePassive, StorPortPassiveFromHwInit

See also

HwStorPassiveInitializeRoutine

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft