PVIDEO_HW_GET_CHILD_DESCRIPTOR Rückruffunktion (video.h)

Artikel
02/07/2025

HwVidGetVideoChildDescriptor einen Deskriptor, einen Typ und eine Identifikationsnummer für ein bestimmtes untergeordnetes Gerät des Anzeigeadapters zurück.

Syntax

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
)
{...}

Parameter

[in] HwDeviceExtension

Zeigen Sie auf den Speicherbereich des Miniporttreibers pro Adapter. Weitere Informationen finden Sie unter Geräteerweiterungen.

[in] ChildEnumInfo

Ist eine VIDEO_CHILD_ENUM_INFO Struktur, die das aufgezählte Gerät beschreibt.

[out] VideoChildType

Zeiger auf eine Position, an der der Miniporttreiber den Typ des untergeordneten Elements zurückgibt, das aufgezählt wird. Dieses Element kann eine der folgenden Elemente aus der VIDEO_CHILD_TYPE Enumeration sein:

Wert	Bedeutung
Überwachen	Das untergeordnete Gerät ist ein Monitor. Wenn der Miniporttreiber erkennt, dass der Monitor über einen DDC2-kompatiblen EDID- Struktur verfügt, sollte der Miniporttreiber die EDID-Informationen aus dem Monitor extrahieren und in den Puffer zurückgeben, auf den pChildDescriptor verweist. Der Miniporttreiber kann die EDID einfacher vom Monitor abrufen, indem VideoPortDDCMonitorHelperaufgerufen wird. Wenn der erkannte Monitor nicht DDC2-kompatibel ist, sollte der Miniporttreiber nichts in pChildDescriptor zurückgeben.
NonPrimaryChip-	Ist für die Systemverwendung reserviert.
VideoChip-	Das untergeordnete Gerät ist der Grafikchip. Der Miniporttreiber sollte diesen Typ zurückgeben, wenn ChildEnumInfo.ChildIndex DISPLAY_ADAPTER_HW_ID ist. Der Miniporttreiber sollte nichts in pChildDescriptor zurückgeben.
Andere	Dem untergeordneten Gerät ist ein separater Gerätetreiber zugeordnet. Der Miniporttreiber sollte den PnP-Hardwarebezeichner des Geräts als Unicode-Zeichenfolge im Puffer zurückgeben, auf die pChildDescriptor verweist. Diese Zeichenfolge muss mit der in der INF-Datei des Treibers angegebenen Geräte-ID übereinstimmen. Sie wird vom Betriebssystem als Hardware-ID für dieses Gerät verwendet.

[out] pChildDescriptor

Zeigen Sie auf einen Puffer, in dem der Miniporttreiber Daten zurückgeben kann, die das Gerät identifizieren. Die zurückgegebenen Informationen hängen vom untergeordneten Typ ab, der in VideoChildType-angegeben ist. Die Größe dieses Puffers wird vom Videoporttreiber im ChildDescriptorSize Member von VIDEO_CHILD_ENUM_INFOangegeben.

[out] UId

Zeigen Sie auf die Position, an der der Miniporttreiber eine eindeutige 32-Bit-Geräte-ID für dieses Gerät zurückgibt. Der Miniporttreiber sollte UId- auf DISPLAY_ADAPTER_HW_ID festlegen, wenn es sich bei dem Gerät um den tatsächlichen Grafikkarten handelt.

[out] pUnused

Ist nicht verwendet und muss auf Null festgelegt werden.

Rückgabewert

HwVidGetVideoChildDescriptor gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
VIDEO_ENUM_INVALID_DEVICE	Rufen Sie erneut an. Der Miniporttreiber konnte das in ChildEnumInfo identifizierte untergeordnete Gerät nicht aufzählen, es gibt jedoch weitere Geräte, die aufgezählt werden sollen.
VIDEO_ENUM_MORE_DEVICES	Ein neues untergeordnetes Gerät wird aufgezählt. Der Videoport ruft HwVidGetVideoChildDescriptor in diesem Fall erneut auf.
VIDEO_ENUM_NO_MORE_DEVICES	Der Miniporttreiber konnte das in ChildEnumInfo identifizierte untergeordnete Gerät nicht aufzählen. Aufzählung beenden. Es gibt keine weiteren Geräte, die aufgezählt werden sollen.

Bemerkungen

Standardmäßig wird HwVidGetVideoChildDescriptor- erst aufgerufen, nachdem das Gerät von HwVidFindAdaptergestartet wurde. Um die Aufzählung der untergeordneten Elemente eines Geräts vor dem Start des Geräts zuzulassen, legen Sie die AllowEarlyEnumeration Member von VIDEO_HW_INITIALIZATION_DATAfest. Wenn AllowEarlyEnumeration festgelegt ist, kann HwVidGetVideoChildDescriptor jederzeit aufgerufen werden.

HwVidGetVideoChildDescriptor- sollten folgende Aktionen ausführen:

Ermitteln Sie den Typ des untergeordneten Geräts basierend auf den in ChildEnumInfobereitgestellten Daten, und geben Sie diesen Typ in VideoChildType-zurück.
Füllen Sie den Puffer aus, auf den pChildDescriptor Punkte mit den entsprechenden Daten zeigt, abhängig vom Wert VideoChildType.
Schreiben Sie einen 32-Bit-Wert in UId-, der das aufgezählte untergeordnete Gerät eindeutig identifiziert. Der Videoporttreiber übergibt dieses Handle für Vorgänge wie die Energieverwaltung an den Miniporttreiber.

HwVidGetVideoChildDescriptor sollte seitenfähig gemacht werden.