HwIdeXGetControllerProperties routine

The HwIdeXGetControllerProperties routine reports properties of the IDE controller hardware in the IDE_CONTROLLER_PROPERTIES structure.

Syntax

PCONTROLLER_PROPERTIES HwIdeXGetControllerProperties;

NTSTATUS HwIdeXGetControllerProperties(
  _In_ PVOID                      DeviceExtension,
  _In_ PIDE_CONTROLLER_PROPERTIES ControllerProperties
)
{ ... }

Parameters

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

  • ControllerProperties [in]
    Points to an IDE_CONTROLLER_PROPERTIES structure that specifies various properties of the IDE controller.

Return value

HwIdeXGetControllerProperties returns STATUS_SUCCESS if the controller information was successfully retrieved or STATUS_REVISION_MISMATCH if the Size member of the ControllerProperties structure does not have the expected value of sizeof(IDE_CONTROLLER_PROPERTIES). This probably indicates that the structure passed to HwIdeXGetControllerProperties in the ControllerProperties parameter is not suitable for the current version of the OS/PCI IDE controller driver.

Remarks

HwIdeXGetControllerProperties examines the controller's configuration data to determine what transfer modes it supports. HwIdeXGetControllerProperties then returns the transfer mode information, along with pointers to a standard set of controller minidriver routines and the values of various flags, in the IDE_CONTROLLER_PROPERTIES structure.

Requirements

Target platform

Desktop

Header

Ide.h (include Ide.h)

See also

IDE_CONTROLLER_PROPERTIES

PciIdeXGetBusData

PciIdeXInitialize

 

 

Send comments about this topic to Microsoft