DXGKDDI_QUERY_INTERFACE funzione di callback (dispmprt.h)

Articolo
02/06/2025

La funzione DxgkDdiQueryInterface restituisce un'interfaccia funzionale implementata dal driver miniport di visualizzazione.

Sintassi

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

NTSTATUS DxgkddiQueryInterface(
  [in] IN_CONST_PVOID MiniportDeviceContext,
  [in] IN_PQUERY_INTERFACE QueryInterface
)
{...}

Parametri

[in] MiniportDeviceContext

Handle per un blocco di contesto associato a una scheda di visualizzazione. La funzione diDxgkDdiAddDevice del driver miniport precedentemente ha fornito questo handle per Dxgkrnl.

[in] QueryInterface

Puntatore a una struttura QUERY_INTERFACE in cui il driver del miniport di visualizzazione deve restituire informazioni sull'interfaccia supportata.

Valore restituito

DxgkDdiQueryInterface restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce un codice NTSTATUS appropriato. Se un driver di miniport di visualizzazione non supporta l'interfaccia richiesta, deve restituire STATUS_NOT_SUPPORTED. Restituendo STATUS_NOT_SUPPORTED, il driver miniport di visualizzazione informa il sistema operativo di passare la query al driver successivo.

Osservazioni

DxgkDdiQueryInterface espone un meccanismo di comunicazione tra il driver miniport di visualizzazione e il driver di un dispositivo figlio (ad esempio, un dispositivo di acquisizione video). Un driver miniport di visualizzazione che espone tale meccanismo deve implementare questa funzione.

DxgkDdiQueryInterface deve compilare i membri della strutturaINTERFACEche QueryInterface->Interface punta a come indicato di seguito:

Impostare dimensioni sul numero di byte nella struttura INTERFACE. Questo valore non deve superare il numero di byte specificato da QueryInterface->Dimensioni.
Impostare Versione sulla versione dell'interfaccia restituita dal driver miniport di visualizzazione. Il driver miniport di visualizzazione deve corrispondere meglio alla versione richiesta dal driver figlio in QueryInterface- versione>.
Impostare Contesto in modo che punti a un contesto di driver miniport visualizzato per l'interfaccia. In genere, un driver miniport di visualizzazione imposta Context sull'handle del blocco di contesto dell'adattatore di visualizzazione identificato da MiniportDeviceContext.
Inizializzare InterfaceReference e InterfaceDereference in modo da puntare alle routine di riferimento e dereferenziazione del driver miniport visualizzate per questa interfaccia.
Inizializzare tutti i membri aggiuntivi specifici dell'interfaccia in modo che puntino alle routine appropriate dell'interfaccia esposta.