共用方式為


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所識別。

  • 初始化 InterfaceReferenceInterfaceDereference,以指向這個介面的顯示迷你埠驅動程序實作參考和取值例程。

  • 初始化所有其他介面特定成員,以指向所公開介面的適當例程。

DxgkDdiQueryInterface 在 IRQL = PASSIVE_LEVEL執行,而且應該設為可分頁。

要求

要求 價值
最低支援的用戶端 Windows Vista
目標平臺 桌面
標頭 dispmprt.h
IRQL PASSIVE_LEVEL

另請參閱

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

QUERY_INTERFACE