DXGKDDI_GET_CHILD_CONTAINER_ID funzione di callback (dispmprt.h)
Esegue una query sull'ID contenitore per la destinazione specificata. Implementato da Windows Display Driver Model (WDDM) 1.2 e versioni successive visualizzano i driver miniport.
Sintassi
DXGKDDI_GET_CHILD_CONTAINER_ID DxgkddiGetChildContainerId;
NTSTATUS DxgkddiGetChildContainerId(
[in] PVOID MiniportDeviceContext,
[in] ULONG ChildUid,
[in, out] PDXGK_CHILD_CONTAINER_ID ContainerId
)
{...}
Parametri
[in] MiniportDeviceContext
Handle di 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 kernel della grafica Microsoft DirectX.
[in] ChildUid
Valore ULONG che identifica in modo univoco il dispositivo figlio. Il driver miniport di visualizzazione in precedenza ha fornito questo identificatore quando è stato chiamato il relativo DxgkDdiQueryChildRelations funzione.
[in, out] ContainerId
Puntatore a una struttura DXGK_CHILD_CONTAINER_ID. Per altre informazioni, vedere la sezione Osservazioni.
Valore restituito
Restituisce uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Il driver ha aggiornato la struttura a cui punta il parametro ContainerId con informazioni sull'ID contenitore ottenute dall'hardware di visualizzazione. |
| STATUS_MONITOR_NODESCRIPTOR | Il driver ha accettato le informazioni predefinite sull'ID contenitore fornite nella struttura a cui punta ContainerId. Nota: Se il driver restituisce questo codice di stato, non deve modificare la struttura. |
In caso contrario, la funzione restituisce uno dei codici di stato definiti in Ntstatus.h.
Osservazioni
Il sistema operativo chiama il driver miniport di visualizzazione DxgkDdiQueryChildRelations funzione per enumerare i dispositivi figlio della scheda di visualizzazione. Il sistema operativo chiama quindi la funzione DxgkDdiQueryDeviceDescriptor del driver miniport di visualizzazione per ogni dispositivo figlio per ottenere i dati EDID (Extended Display Information Data) per il dispositivo. Per altre informazioni su questa procedura, vedere Enumerating Child Devices of a Display Adapter.
In base ai dati EDID del dispositivo, il sistema operativo genera un ID contenitore predefinito per il dispositivo figlio. Il sistema operativo chiama quindi la funzione dxgkDdiGetChildContainerId del driver miniport di visualizzazione e passa un puntatore a una struttura DXGK_CHILD_CONTAINER_ID tramite il parametro ContainerId. Il membro ContainerId di questa struttura contiene l'ID contenitore predefinito per il dispositivo di visualizzazione figlio.
Il driver miniport di visualizzazione può accettare l'ID contenitore predefinito o impostare il membro ContainerId su un identificatore univoco per il dispositivo prima che venga restituito dalla chiamata a DxgkDdiGetChildContainerId.
Per altre informazioni sugli ID contenitore, vedere ID contenitore .
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 8 |
| server minimo supportato | Windows Server 2012 |
| piattaforma di destinazione | Desktop |
| intestazione | dispmprt.h |
| IRQL | PASSIVE_LEVEL |