DXGKDDI_QUERY_INTERFACE回呼函式 (dispmprt.h)

發行項
05/23/2024

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> 指向的 INTERFACE 結構成員，如下所示：

將 Size 設定為 INTERFACE 結構中的位元元組數目。此值不得超過 QueryInterface-Size> 所指定的位元元組數目。
將 [版本 ] 設定為顯示迷你埠驅動程式所傳回之介面的版本。顯示迷你埠驅動程序應該最符合 QueryInterface-Version> 中子驅動程式所要求的版本。
將 Context 設定為指向介面的顯示迷你埠驅動程式定義內容。一般而言，顯示迷你埠驅動程式會將 Context 設定為由 MiniportDeviceContext所識別之顯示器配接器內容區塊的句柄。
初始化 InterfaceReference 和 InterfaceDereference ，以指向此介面的顯示迷你埠驅動程式實作參考和取值例程。
初始化所有其他介面特定成員，以指向所公開介面的適當例程。