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 列舉：
| 值 | 意義 |
|---|---|
| 監視器 | 子裝置是監視器。 如果迷你埠驅動程式偵測到監視器具有與 DDC2 相容的 EDID 結構，迷你埠驅動程式應該從監視器擷取 EDID 資訊，並在 pChildDescriptor 指向的緩衝區中傳回它。 迷你埠驅動程式可以呼叫 VideoPortDDCMonitorHelper，更輕鬆地從監視器取得 EDID。 如果偵測到的監視器不符合 DDC2 標準，迷你埠驅動程式不應該傳回 pChildDescriptor 中的任何專案。 |
| NonPrimaryChip | 保留供系統使用。 |
| VideoChip | 子裝置是圖形晶元。 當 ChildEnumInfo.ChildIndex DISPLAY_ADAPTER_HW_ID時，迷你埠驅動程式應該會傳回此類型。 迷你埠驅動程序不應該傳回 pChildDescriptor 中的任何專案。 |
| 其他 | 子裝置有與其相關聯的個別設備驅動器。 迷你埠驅動程序應該會將裝置的 PnP 硬體識別碼傳回為 pChildDescriptor 指向的緩衝區中的 Unicode 字串。 此字串必須符合驅動程式 INF 檔案中指定的 裝置識別碼。 作系統將使用它作為此裝置的硬體標識碼。 |
[out] pChildDescriptor
迷你埠驅動程式可以傳回識別裝置之數據的緩衝區指標。 傳回的信息取決於 videoChildType中所指定的子類型。 這個緩衝區的大小是由 ChildDescriptorSize 成員 VIDEO_CHILD_ENUM_INFO中的視訊埠驅動程式指定。
[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 中所識別的子裝置。 停止列舉。 不會再列舉任何裝置。 |
言論
根據預設，HwVidGetVideoChildDescriptor，直到 HwVidFindAdapter啟動裝置之後，才會呼叫 。 若要允許在裝置啟動之前列舉裝置的子系，請設定 VIDEO_HW_INITIALIZATION_DATA的allowEarlyEnumeration 成員。 AllowEarlyEnumeration 設定時 ，您可以隨時呼叫 HwVidGetVidGetVideoChildDescriptor。
HwVidGetVideoChildDescriptor 應該執行下列動作：
- 根據 ChildEnumInfo 中提供的數據來判斷子裝置的類型，並在 videoChildType 中傳回此類型。
- 根據 videoChildType 值而定，填入 pChildDescriptor 指向適當數據的緩衝區。
- 在 UId 中寫入 32 位值，以唯一識別所列舉的子裝置。 視訊埠驅動程式會將此句柄傳回迷你埠驅動程式，以進行電源管理等作業。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 桌面 |
| 標頭 | video.h （include Video.h） |