Edit

PFNKSPINPOWER callback function (ks.h)

  • Article

An AVStream minidriver's AVStrMiniPinPower routine is called for pin-centric pins when the device is waking or entering a sleep state.

Syntax

PFNKSPINPOWER Pfnkspinpower;

void Pfnkspinpower(
  [in] PKSPIN Pin,
  [in] DEVICE_POWER_STATE State
)
{...}

Parameters

[in] Pin

Points to a pin-centric KSPIN structure for which to register the callback.

[in] State

Specifies the device power state being requested. Set this parameter to one of the following DEVICE_POWER_STATE enumeration values: PowerDeviceD0, PowerDeviceD1, PowerDeviceD2, or PowerDeviceD3.

Return value

None

Remarks

Warning

Do not attempt to obtain the filter control mutex from within either the Sleep or Wake callback. Doing so induces a risk of deadlock. For more information about mutexes, see Mutexes in AVStream.

The minidriver specifies an address for routines of this type in the Sleep and/or Wake parameters of the KsPinRegisterPowerCallbacks routine.

Requirements

Requirement Value
Target Platform Desktop
Header ks.h (include Ks.h)

See also

KsFilterRegisterPowerCallbacks

KsPinRegisterPowerCallbacks