Edit

Share via

StorPortEnablePassiveInitialization function (storport.h)

  • Article

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

Syntax

BOOLEAN StorPortEnablePassiveInitialization(
  [in] PVOID                          DeviceExtension,
  [in] PHW_PASSIVE_INITIALIZE_ROUTINE HwPassiveInitializeRoutine
);

Parameters

[in] DeviceExtension

Pointer to the per-adapter device extension.

[in] HwPassiveInitializeRoutine

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

Requirement Value
Target Platform Universal
Header storport.h (include Storport.h)
IRQL DIRQL
DDI compliance rules StorPortEnablePassive(storport), StorPortPassiveFromHwInit(storport)

See also

HwStorPassiveInitializeRoutine