HwIdeXChannelEnabled routine

The HwIdeXChannelEnabled routine is called to determine whether Channel is enabled.

Syntax

PCIIDE_CHANNEL_ENABLED HwIdeXChannelEnabled;

IDE_CHANNEL_STATE HwIdeXChannelEnabled(
  _In_ PVOID DeviceExtension,
  _In_ ULONG Channel
)
{ ... }

Parameters

  • DeviceExtension [in]
    Contains a pointer to the controller minidriver's device extension.

  • Channel [in]
    Specifies which channel is being queried. This parameter must be assigned a value of 0 or 1.

Return value

HwIdeXChannelEnabled must return one of three enumeration values of type IDE_CHANNEL_STATE:

Return code Description
ChannelDisabled

 

Remarks

An IDE controller minidriver must implement an HwIdeXChannelEnabled routine to report whether the specified channel is enabled or not. HwIdeXChannelEnabled retrieves the needed information from the PCI configuration space by calling the minidriver library routine PciIdeXGetBusData.

When the controller driver calls minidriver's HwIdeXGetControllerProperties routine, it passes an IDE_CONTROLLER_PROPERTIES structure to the minidriver. The minidriver must store a pointer to HwIdeXChannelEnabled in this structure.

Requirements

Target platform

Desktop

Header

Ide.h (include Ide.h)

See also

HwIdeXGetControllerProperties

IDE_CONTROLLER_PROPERTIES

PciIdeXGetBusData

 

 

Send comments about this topic to Microsoft