PciIdeXInitialize routine

The PciIdeXInitialize routine initializes a controller minidriver.

Syntax

NTSTATUS PciIdeXInitialize(
  _In_ PDRIVER_OBJECT         DriverObject,
  _In_ PUNICODE_STRING        RegistryPath,
  _In_ PCONTROLLER_PROPERTIES HwGetControllerProperties,
  _In_ ULONG                  ExtensionSize
);

Parameters

  • DriverObject [in]
    Contains a pointer to the controller minidriver's driver object.

  • RegistryPath [in]
    Contains a Unicode string that indicates the location in the registry where the minidriver's configuration information is stored.

  • HwGetControllerProperties [in]
    Contains a pointer to the HwIdeXGetControllerProperties controller minidriver routine that queries for the PCI IDE controller properties.

  • ExtensionSize [in]
    Specifies the size in bytes of the driver extension.

Return value

PciIdeXInitialize returns STATUS_SUCCESS if the allocation of the driver extension succeeds, and the appropriate error code otherwise.

Remarks

An IDE controller minidriver must call PciIdeXInitialize from its DriverEntry of IDE Controller Minidriver routine PciIdeXInitialize initializes the controller minidriver's dispatch tables and allocates an extension for the DriverObject. This routine then stores the ExtensionSize and a pointer to the HwIdeXGetControllerProperties routine in the DriverObject extension.

An IDE controller minidriver must also implement a routine that reports the properties of the IDE controller. A pointer to this routine is passed to PciIdeXInitialize in its HwGetControllerProperties parameter.

Requirements

Target platform

Desktop

Header

Ide.h (include Ide.h)

Library

Pciidex.lib

See also

IDE_CONTROLLER_PROPERTIES

HwIdeXGetControllerProperties

 

 

Send comments about this topic to Microsoft