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 會傳回下列其中一個值:

傳回碼 描述
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