PVIDEO_HW_GET_CHILD_DESCRIPTOR video.h) (回呼函式

發行項
02/29/2024

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 中所識別的子裝置。停止列舉。沒有其他要列舉的裝置。

備註

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

HwVidGetVideoChildDescriptor 應該執行下列動作：