PVIDEO_HW_GET_CHILD_DESCRIPTOR funzione di callback (video.h)

Articolo
02/29/2024

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 Estensioni del dispositivo.

[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
Monitoraggio	Il dispositivo figlio è un monitoraggio. Se il driver miniport rileva che il monitor ha una struttura EDID conforme a DDC2 associata, il driver miniport deve estrarre le informazioni EDID dal monitoraggio e restituirlo nel buffer a cui punta pChildDescriptor. Il driver miniport può ottenere più facilmente l'EDID dal monitor chiamando VideoPortDDCMonitorHelper. Se il monitoraggio 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.
Altri	Il dispositivo figlio ha un driver di dispositivo separato associato. 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 a 32 bit univoco per questo dispositivo. Il driver miniport deve impostare UId per essere DISPLAY_ADAPTER_HW_ID quando il dispositivo è l'adattatore di visualizzazione effettivo.

[out] pUnused

È inutilizzato e deve essere impostato su zero.

Valore restituito

HwVidGetVideoChildDescriptor restituisce uno dei valori seguenti:

Codice restituito	Descrizione
VIDEO_ENUM_INVALID_DEVICE	Chiama di nuovo. Impossibile enumerare il dispositivo figlio identificato in ChildEnumInfo, ma sono presenti altri dispositivi da enumerare.
VIDEO_ENUM_MORE_DEVICES	Viene enumerato un nuovo dispositivo figlio. La porta video chiamerà nuovamente HwVidGetVideoChildDescriptor in questo caso.
VIDEO_ENUM_NO_MORE_DEVICES	Impossibile enumerare il dispositivo figlio identificato in ChildEnumInfo. Arrestare l'enumerazione. Non sono presenti più dispositivi da enumerare.

Commenti

Per impostazione predefinita, HwVidGetVideoChildDescriptor non viene chiamato fino a quando il dispositivo viene avviato da HwVidFindAdapter. Per consentire l'enumerazione dei figli di un dispositivo prima dell'avvio del dispositivo, impostare il membro AllowEarlyEnumeration di VIDEO_HW_INITIALIZATION_DATA. Quando AllowEarlyEnumeration è impostato, È possibile chiamare HwVidGetVideoChildDescriptor in qualsiasi momento.

HwVidGetVideoChildDescriptor deve eseguire le operazioni seguenti:

Determinare il tipo del dispositivo figlio in base ai dati forniti in ChildEnumInfo e restituire questo tipo in VideoChildType.
Compilare il buffer a cui pChildDescriptor punta 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 la gestione della potenza.

HwVidGetVideoChildDescriptor deve essere reso paginabile.