PVIDEO_HW_GET_CHILD_DESCRIPTOR funzione di callback (video.h)

Articolo
02/07/2025

HwVidGetVideoChildDescriptor restituisce un descrittore, un tipo e un numero di identificazione per un particolare dispositivo figlio della scheda di visualizzazione.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'area di archiviazione per adattatore del driver miniport. Per altre informazioni, vedere Device Extensions.

[in] ChildEnumInfo

Struttura VIDEO_CHILD_ENUM_INFO che descrive il dispositivo da enumerare.

[out] VideoChildType

Puntatore a una posizione in cui il driver miniport restituisce il tipo di figlio da enumerare. Questo membro può essere uno dei seguenti dall'enumerazione VIDEO_CHILD_TYPE:

valore	significato
Monitor	Il dispositivo figlio è un monitor. Se il driver miniport rileva che il monitor ha una struttura conforme a DDC2 EDID associata, il driver miniport deve estrarre le informazioni EDID dal monitor e restituirlo nel buffer a cui punta pChildDescriptor. Il driver miniport può ottenere più facilmente l'EDID dal monitor chiamando VideoPortDDCMonitorHelper. Se il monitor rilevato non è conforme a DDC2, il driver miniport non deve restituire nulla in pChildDescriptor.
nonPrimaryChip	È riservato per l'uso del sistema.
VideoChip	Il dispositivo figlio è il chip grafico. Il driver miniport deve restituire questo tipo quando ChildEnumInfo.ChildIndex è DISPLAY_ADAPTER_HW_ID. Il driver miniport non deve restituire nulla in pChildDescriptor.
Altro	Al dispositivo figlio è associato un driver di dispositivo separato. Il driver miniport deve restituire l'identificatore hardware PnP del dispositivo come stringa Unicode nel buffer a cui punta pChildDescriptor. Questa stringa deve corrispondere all'ID dispositivo specificato nel file INF del driver. Verrà usato dal sistema operativo come ID hardware per questo dispositivo.

[out] pChildDescriptor

Puntatore a un buffer in cui il driver miniport può restituire dati che identificano il dispositivo. Le informazioni restituite dipendono dal tipo figlio specificato in VideoChildType. Le dimensioni di questo buffer vengono specificate dal driver della porta video nel membro ChildDescriptorSize di VIDEO_CHILD_ENUM_INFO.

[out] UId

Puntatore alla posizione in cui il driver miniport restituisce un ID dispositivo univoco a 32 bit per questo dispositivo. Il driver miniport deve impostare UId per essere DISPLAY_ADAPTER_HW_ID quando il dispositivo è la scheda di visualizzazione effettiva.

[out] pUnused

Non usato e deve essere impostato su zero.

Valore restituito

HwVidGetVideoChildDescriptor restituisce uno dei valori seguenti:

Codice restituito	Descrizione
VIDEO_ENUM_INVALID_DEVICE	Chiama di nuovo. Il driver miniport non è riuscito ad enumerare il dispositivo figlio identificato in ChildEnumInfo, ma sono presenti più dispositivi da enumerare.
VIDEO_ENUM_MORE_DEVICES	Viene enumerato un nuovo dispositivo figlio. In questo caso, la porta video chiamerà di nuovo HwVidGetVideoChildDescriptor.
VIDEO_ENUM_NO_MORE_DEVICES	Il driver miniport non è riuscito a enumerare il dispositivo figlio identificato in ChildEnumInfo. Enumerazione Stop. Non sono presenti altri dispositivi da enumerare.

Osservazioni

Per impostazione predefinita, HwVidGetVideoChildDescriptor non viene chiamato finché il dispositivo non viene avviato da HwVidFindAdapter. Per consentire l'enumerazione degli elementi figlio di un dispositivo prima dell'avvio del dispositivo, impostare il AllowEarlyEnumeration membro di VIDEO_HW_INITIALIZATION_DATA. Quando viene impostata AllowEarlyEnumeration, è possibile chiamare HwVidGetVideoChildDescriptor in qualsiasi momento.

HwVidGetVideoChildDescriptor deve eseguire le operazioni seguenti:

Determinare il tipo del dispositivo figlio in base ai dati forniti in ChildEnumInfoe restituire questo tipo in VideoChildType.
Compilare il buffer in cui pChildDescriptor punti con i dati appropriati, a seconda del valore di VideoChildType.
Scrivere un valore a 32 bit in UId che identifica in modo univoco il dispositivo figlio da enumerare. Il driver della porta video passerà di nuovo questo handle al driver miniport per operazioni come il risparmio energia.

HwVidGetVideoChildDescriptor deve essere reso pageable.