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 函式先前已將此句柄提供給 Microsoft DirectX 圖形核心子系統。

[in] QueryInterface

QUERY_INTERFACE 結構的指標，顯示迷你埠驅動程序應該會傳回它所支援介面的相關信息。

傳回值

如果成功，DxgkDdiQueryInterface 會傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。 如果顯示迷你埠驅動程序不支援要求的介面，它必須傳回STATUS_NOT_SUPPORTED。 藉由傳回STATUS_NOT_SUPPORTED，顯示迷你埠驅動程式會通知操作系統將查詢傳遞給下一個驅動程式。

備註

DxgkDdiQueryInterface 會公開顯示迷你埠驅動程式與子裝置驅動程式之間的通訊機制 (，例如視訊擷取裝置) 。 公開這類機制的顯示迷你埠驅動程序應該實作此函式。

DxgkDdiQueryInterface 應該填入 QueryInterface-Interface> 指向的 INTERFACE 結構成員，如下所示：

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

DxgkDdiQueryInterface 會在 IRQL = PASSIVE_LEVEL 執行，而且應該可分頁。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	桌面
標頭	dispmprt.h
IRQL	PASSIVE_LEVEL

另請參閱

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

QUERY_INTERFACE