DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction DxgkDdiSetDisplayPrivateDriverFormat modifie l’attribut de format privé d’une source présente vidéo.

Syntaxe

DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT DxgkddiSetdisplayprivatedriverformat;

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

Paramètres

[in] hAdapter

Handle vers un bloc de contexte associé à un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique Microsoft DirectX dans le MiniportDeviceContext paramètre de sortie de la fonction DxgkDdiAddDevice.

[in] pSetDisplayPrivateDriverFormat

Pointeur vers une structure DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT qui contient des arguments de fonction.

Valeur de retour

DxgkDdiSetDisplayPrivateDriverFormat retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne STATUS_UNSUCCESSFUL pour indiquer que le pilote n’a pas pu modifier l’attribut de format privé de la vidéo donnée source présente.

Remarques

Le sous-système du noyau graphique DirectX appelle le du pilote miniport d’affichage DxgkDdiSetDisplayPrivateDriverFormat fonction après que le pilote d’affichage en mode utilisateur appelle la fonction de rappel pfnSetDisplayPrivateDriverFormatCb fonction de rappel. Par exemple, le pilote d’affichage en mode utilisateur peut appeler pfnSetDisplayPrivateDriverFormatCb pour modifier le format swizzling de la vidéo présente source lorsqu’une modification de capture d’écran intégral est créée. Le sous-système du noyau graphique DirectX appelle ensuite le du pilote miniport d’affichage DxgkDdiSetDisplayPrivateDriverFormat pour modifier le format du pilote privé de la source actuelle de la vidéo. Cela permet l’affichage de l’allocation principale sur la vidéo présente source sans avoir besoin de traduction de la surface primaire.

RemarqueDxgkDdiSetDisplayPrivateDriverFormat n’applique pas le format de pilote privé que le PrivateDriverFormatAttribute membre de la structure DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT pointée par pSetDisplayPrivateDriverFormat spécifie à n’importe quelle allocation. DxgkDdiSetDisplayPrivateDriverFormat applique le format de pilote privé directement à la source actuelle de la vidéo. Par exemple, DxgkDdiSetDisplayPrivateDriverFormat peut réprogramquer les registres DAC pour effectuer une analyse à partir d’un autre format swizzling.

DxgkDdiSetDisplayPrivateDriverFormat doit être rendu paginable.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
plateforme cible	Bureau
d’en-tête	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Voir aussi

DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT

pfnSetDisplayPrivateDriverFormatCb

Partager via