DXGKDDI_QUERY_CHILD_RELATIONS funzione di callback (dispmprt.h)

Articolo
02/06/2025

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 per un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver miniport di visualizzazione ha fornito in precedenza questo handle al sottosistema del kernel grafico DirectX.

[in, out] ChildRelations

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

[in] ChildRelationsSize

Dimensioni totali, in byte, della matrice ChildRelations inclusa la struttura azzerato 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.

Osservazioni

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

Il driver di miniport di visualizzazione deve compilare una matrice di strutture DXGK_CHILD_DESCRIPTOR, una per ognuno degli elementi figlio dell'adattatore 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 impaginabile.