DXGKDDI_QUERY_CHILD_RELATIONS funzione di callback (dispmprt.h)

Articolo
05/23/2024

La funzione DxgkDdiQueryChildRelations enumera i dispositivi figlio di una scheda di visualizzazione.

Sintassi

DXGKDDI_QUERY_CHILD_RELATIONS DxgkddiQueryChildRelations;

NTSTATUS DxgkddiQueryChildRelations(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] PDXGK_CHILD_DESCRIPTOR ChildRelations,
  [in]      ULONG ChildRelationsSize
)
{...}

Parametri

[in] MiniportDeviceContext

Handle a un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver di visualizzazione ha fornito in precedenza questo handle al sottosistema del kernel della grafica DirectX.

[in, out] ChildRelations

Puntatore a una matrice di strutture DXGK_CHILD_DESCRIPTOR allocata e zero dal chiamante. Il numero di elementi nella matrice è maggiore del valore restituito da DxgkDdiStartDevice nel parametro NumberOfChildren . DxgkDdiQueryChildRelations deve compilare tutte le strutture della matrice con informazioni che descrivono i dispositivi figlio dell'adattatore di visualizzazione. L'ultima struttura nella matrice deve rimanere zero.

[in] ChildRelationsSize

Dimensioni totali, in byte, della matrice ChildRelations , inclusa la struttura zero alla fine.

Valore restituito

DxgkDdiQueryChildRelations restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

Tutti i dispositivi figlio della scheda di visualizzazione vengono onboardati; monitoraggi e altri dispositivi esterni che si connettono alla scheda di visualizzazione non sono considerati dispositivi figlio.

Il driver miniport di visualizzazione deve compilare una matrice di strutture DXGK_CHILD_DESCRIPTOR, una per ognuno dei figli della scheda di visualizzazione. La matrice deve contenere strutture DXGK_CHILD_DESCRIPTOR per tutti i dispositivi figlio correnti e tutti i potenziali dispositivi figlio. Ad esempio, se l'ancoraggio di un computer portatile comporterà la disponibilità di nuovi output video, tali output video devono avere descrittori nella matrice, anche se non sono attualmente disponibili.

La funzione DxgkDdiQueryChildRelations deve essere resa paginabile.