DXGKDDI_QUERY_INTERFACE回呼函式 (dispmprt.h)
DxgkDdiQueryInterface 函式會傳回顯示迷你埠驅動程式所實作的功能介面。
語法
DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;
NTSTATUS DxgkddiQueryInterface(
[in] IN_CONST_PVOID MiniportDeviceContext,
[in] IN_PQUERY_INTERFACE QueryInterface
)
{...}
參數
[in] MiniportDeviceContext
與顯示配接器相關聯的內容區塊句柄。 顯示迷你連接埠驅動程式的 DxgkDdiAddDevice 函式先前提供此句柄來 Dxgkrnl。
[in] QueryInterface
QUERY_INTERFACE 結構的指標,顯示迷你埠驅動程序應該傳回其支援的介面相關信息。
傳回值
DxgkDdiQueryInterface 會在成功時傳回STATUS_SUCCESS;否則,它會傳回適當的NTSTATUS程式代碼。 如果顯示迷你埠驅動程序不支援要求的介面,則必須傳回STATUS_NOT_SUPPORTED。 藉由傳回STATUS_NOT_SUPPORTED,顯示迷你埠驅動程式會通知作系統將查詢傳遞給下一個驅動程式。
言論
DxgkDdiQueryInterface 會公開顯示迷你埠驅動程式與子裝置驅動程式之間的通訊機制(例如視訊擷取裝置)。 公開這類機制的顯示迷你埠驅動程序應該實作此函式。
DxgkDdiQueryInterface 應該填入 QueryInterface->介面 指向的 INTERFACE 結構成員,如下所示:
將 Size 設定為 INTERFACE 結構中的位元元組數目。 這個值不能超過 QueryInterface ->Size所指定的位元組數目。
將 Version 設定為顯示迷你埠驅動程式所傳回的介面版本。 顯示迷你埠驅動程序應該最符合 QueryInterface->版本中子驅動程式所要求的版本。
將 內容 設定為指向介面的顯示迷你埠驅動程式定義內容。 一般而言,顯示迷你埠驅動程式會將 Context 設定為顯示配接器內容區塊的句柄,此區塊是由 MiniportDeviceContext所識別。
初始化 InterfaceReference 和 InterfaceDereference,以指向這個介面的顯示迷你埠驅動程序實作參考和取值例程。
初始化所有其他介面特定成員,以指向所公開介面的適當例程。
DxgkDdiQueryInterface 在 IRQL = PASSIVE_LEVEL執行,而且應該設為可分頁。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
目標平臺 | 桌面 |
標頭 | dispmprt.h |
IRQL | PASSIVE_LEVEL |