DXGKDDI_QUERY_INTERFACE funzione di callback (dispmprt.h)

Articolo
05/23/2024

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 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 a Dxgkrnl.

[in] QueryInterface

Puntatore a una struttura QUERY_INTERFACE in cui il driver 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 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.

Commenti

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 struttura INTERFACE a cui QueryInterface-Interface> punta come indicato di seguito:

Impostare Size sul numero di byte nella struttura INTERFACE. Questo valore non deve superare il numero di byte specificato da QueryInterface-Size>.
Impostare Version (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-Version>.
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.
Inizializza InterfaceReference e InterfaceDereference per puntare alle routine di riferimento e dereferenziazione implementate dal driver miniport di visualizzazione per questa interfaccia.
Inizializzare tutti i membri aggiuntivi specifici dell'interfaccia in modo che puntino alle routine appropriate dell'interfaccia esposta.