DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT コールバック関数 (d3dkmddi.h)

DxgkDdiSetDisplayPrivateDriverFormat 関数は、ビデオの現在のソースの private-format 属性を変更します。

構文

DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT DxgkddiSetdisplayprivatedriverformat;

NTSTATUS DxgkddiSetdisplayprivatedriverformat(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT pSetDisplayPrivateDriverFormat
)
{...}

パラメーター

[in] hAdapter

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、以前、DxgkDdiAddDevice 関数の MiniportDeviceContext 出力パラメーターで Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。

[in] pSetDisplayPrivateDriverFormat

関数引数を含む DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT 構造体へのポインター。

戻り値

DxgkDdiSetDisplayPrivateDriverFormat は、成功した場合STATUS_SUCCESSを返します。それ以外の場合は、ドライバーが特定のビデオ存在ソースの private-format 属性を変更できなかったことを示すSTATUS_UNSUCCESSFULを返します。

注釈

DirectX グラフィックス カーネル サブシステムは、ユーザー モードディスプレイ ドライバーが pfnSetDisplayPrivateDriverFormatCb コールバック関数を呼び出した後、ディスプレイ ミニポート ドライバーの DxgkDdiSetDisplayPrivateDriverFormat 関数を呼び出します。 たとえば、ユーザー モードのディスプレイ ドライバーは、全画面表示の反転の変更が作成されたときに、ビデオの現在のソースの swizzling 形式を変更する pfnSetDisplayPrivateDriverFormatCb を呼び出す可能性があります。 DirectX グラフィックス カーネル サブシステムは、ディスプレイ ミニポート ドライバーの DxgkDdiSetDisplayPrivateDriverFormat を呼び出して、ビデオの現在のソースのプライベート ドライバー形式を変更します。 これにより、プライマリ サーフェスの変換を必要とせずに、プライマリ割り当てをビデオの現在のソースに表示できます。

DxgkDdiSetDisplayPrivateDriverFormat では、pSetDisplayPrivateDriverFormat が指すDXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT構造体の PrivateDriverFormatAttribute メンバーが割り当てに指定するプライベート ドライバー形式は適用されません。 DxgkDdiSetDisplayPrivateDriverFormat は、プライベート ドライバー形式をビデオの現在のソースに直接適用します。 たとえば、 DxgkDdiSetDisplayPrivateDriverFormat は、別のスウィズリング形式からスキャンするように DAC レジスタを再プログラミングする場合があります。
 
DxgkDdiSetDisplayPrivateDriverFormat を ページング可能にする必要があります。

要件

要件
サポートされている最小のクライアント Windows Vista
対象プラットフォーム デスクトップ
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

こちらもご覧ください

DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT

pfnSetDisplayPrivateDriverFormatCb