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 a un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver di visualizzazione ha precedentemente fornito questo handle al sottosistema kernel della grafica Microsoft DirectX.
[in] ChildUid
Valore ULONG che identifica in modo univoco il dispositivo figlio. Il driver miniport visualizzato in precedenza ha fornito questo identificatore quando è stata chiamata la funzione DxgkDdiQueryChildRelations .
[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 fa riferimento il parametro ContainerId con le 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 fa riferimento 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.
Commenti
Il sistema operativo chiama la funzione DxgkDdiQueryChildRelations del driver di visualizzazione del miniport per enumerare i dispositivi figlio della scheda di visualizzazione. Il sistema operativo chiama quindi la funzione DxgkDdiQueryDeviceDescriptor del driver 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 Enumerazione dei dispositivi figlio di una scheda di visualizzazione.
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 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 visualizzato 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 |
| Server minimo supportato | Windows Server 2012 |
| Piattaforma di destinazione | Desktop |
| Intestazione | dispmprt.h |
| IRQL | PASSIVE_LEVEL |