StorPortGetDeviceObjects 函式 (storport.h)

  • 發行項

StorPortGetDeviceObjects 例程會傳回與配接器裝置堆疊相關聯的裝置物件。 將會傳回的裝置對像是適配卡的功能和實體裝置物件，以及附加功能裝置物件的裝置物件。

語法

ULONG StorPortGetDeviceObjects(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *AdapterDeviceObject,
  [out] PVOID *PhysicalDeviceObject,
  [out] PVOID *LowerDeviceObject
);

參數

[in] HwDeviceExtension

主機總線適配卡的硬體裝置擴充功能指標， (HBA) 。

[out] AdapterDeviceObject

接收適配卡之功能裝置物件 (FDO) 指標。

[out] PhysicalDeviceObject

要接收實體裝置物件的指標， (PDO) 。

[out] LowerDeviceObject

要接收 FDO 所連結下層裝置之裝置物件的指標。

傳回值

StorPortGetDeviceObjects 會傳回下列其中一個狀態代碼：

傳回碼 Description
STOR_STATUS_NOT_IMPLEMENTED
 此函式不會在作用中的操作系統上實作。
STOR_STATUS_SUCCESS
 表示已成功取得裝置物件。
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension 為 NULL。

規格需求

需求 值
目標平台 Universal
標頭 storport.h (包含 Storport.h)