共用方式為


PVIDEO_HW_GET_CHILD_DESCRIPTOR video.h) (回呼函式

HwVidGetVideoChildDescriptor 會傳回顯示配接器之特定子裝置的描述項、類型和標識符。

語法

PVIDEO_HW_GET_CHILD_DESCRIPTOR PvideoHwGetChildDescriptor;

VP_STATUS PvideoHwGetChildDescriptor(
  [in]  IN PVOID HwDeviceExtension,
  [in]  IN PVIDEO_CHILD_ENUM_INFO ChildEnumInfo,
  [out] OUT PVIDEO_CHILD_TYPE VideoChildType,
  [out] OUT PUCHAR pChildDescriptor,
  [out] OUT PULONG UId,
  [out] OUT PULONG pUnused
)
{...}

參數

[in] HwDeviceExtension

迷你埠驅動程式每個適配卡儲存區域的指標。 如需詳細資訊,請參閱 裝置擴充功能

[in] ChildEnumInfo

這是描述所列舉裝置 的VIDEO_CHILD_ENUM_INFO 結構。

[out] VideoChildType

迷你埠驅動程式傳回要列舉之子系類型的位置指標。 此成員可以是下列VIDEO_CHILD_TYPE列舉的其中一個:

ReplTest1 意義
監視器 子裝置是監視器。 如果迷你埠驅動程式偵測到監視器有相關聯的 DDC2 相容 EDID 結構,迷你埠驅動程式應該從監視器擷取 EDID 資訊,並在 pChildDescriptor 指向的緩衝區中傳回它。 迷你埠驅動程式可以透過呼叫 VideoPortDDCMonitorHelper,更輕鬆地從監視器取得EDID。
如果偵測到的監視器不符合 DDC2 標準,迷你埠驅動程式就不應該傳回 pChildDescriptor 中的任何專案。
NonPrimaryChip 保留供系統使用。
VideoChip 子裝置是圖形晶元。
當 ChildEnumInfo.ChildIndex DISPLAY_ADAPTER_HW_ID時,迷你埠驅動程式應該會傳回此類型。 迷你埠驅動程序不應該傳回 pChildDescriptor 中的任何專案。
其他 子裝置有與其相關聯的個別設備驅動器。
迷你埠驅動程序應該會將裝置的 PnP 硬體識別碼傳回為 pChildDescriptor 指向的緩衝區中的 Unicode 字串。 此字串必須符合驅動程式 INF 檔案中指定的 裝置 識別碼。 操作系統將會使用此作業系統作為此裝置的硬體識別碼。

[out] pChildDescriptor

迷你埠驅動程式可以傳回可識別裝置之數據的緩衝區指標。 傳回的信息取決於 VideoChildType 中指定的子類型。 此緩衝區的大小是由 VIDEO_CHILD_ENUM_INFO的 ChildDescriptorSize 成員中的視訊埠驅動程式所指定。

[out] UId

迷你埠驅動程式為此裝置傳回唯一 32 位 裝置 識別碼的位置指標。 當裝置是實際的顯示器適配卡時,迷你埠驅動程序應該將 UId 設定為DISPLAY_ADAPTER_HW_ID。

[out] pUnused

未使用且必須設定為零。

傳回值

HwVidGetVideoChildDescriptor 會傳回下列其中一個值:

傳回碼 Description
VIDEO_ENUM_INVALID_DEVICE 再次呼叫 。 迷你埠驅動程序無法列舉 ChildEnumInfo 中所識別的子裝置,但需要列舉更多裝置。
VIDEO_ENUM_MORE_DEVICES 會列舉新的子裝置。 在此案例中,視訊埠會再次呼叫 HwVidGetVideoChildDescriptor。
VIDEO_ENUM_NO_MORE_DEVICES 迷你埠驅動程序無法列舉 ChildEnumInfo 中所識別的子裝置。 停止列舉。 沒有其他要列舉的裝置。

備註

根據預設, HwVidGetVideoChildDescriptorHwVidFindAdapter 啟動裝置之後才會呼叫。 若要允許在啟動裝置之前列舉裝置的子系,請設定 VIDEO_HW_INITIALIZATION_DATAAllowEarlyEnumeration 成員。 設定 AllowEarlyEnumeration 時,可以隨時呼叫 HwVidGetVideoChildDescriptor

HwVidGetVideoChildDescriptor 應該執行下列動作:

  • 根據 ChildEnumInfo 中提供的數據來判斷子裝置的類型,並在 VideoChildType 中傳回此類型。
  • 根據 VideoChildType 的值,填入 pChildDescriptor 指向適當數據的緩衝區。
  • UId 撰寫32位值,以唯一識別所列舉的子裝置。 視訊埠驅動程式會將此句柄傳回迷你埠驅動程式,以進行電源管理等作業。
HwVidGetVideoChildDescriptor 應設為可分頁。

規格需求

需求
目標平台 桌面
標頭 video.h (包含 Video.h)

另請參閱

HwVidGetPowerState

HwVidSetPowerState

VIDEO_CHILD_ENUM_INFO

VideoPortDDCMonitorHelper

VideoPortEnumerateChildren