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