DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT fonction de rappel (d3dkmddi.h)

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

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 paramètre de sortie MiniportDeviceContext de la fonction DxgkDdiAddDevice .

[in] pSetDisplayPrivateDriverFormat

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

Valeur retournée

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 source actuelle de la vidéo donnée.

Remarques

Le sous-système du noyau graphique DirectX appelle la fonction DxgkDdiSetDisplayPrivateDriverFormat du pilote de miniport d’affichage après que le pilote d’affichage en mode utilisateur a appelé la fonction de rappel pfnSetDisplayPrivateDriverFormatCb . Par exemple, le pilote d’affichage en mode utilisateur peut appeler pfnSetDisplayPrivateDriverFormatCb pour modifier le format pivotant de la source actuelle de la vidéo lorsqu’une modification de basculement en plein écran est créée. Le sous-système du noyau graphique DirectX appelle ensuite DxgkDdiSetDisplayPrivateDriverFormat du pilote miniport d’affichage pour modifier le format du pilote privé de la source vidéo présente. Cela permet d’afficher l’allocation primaire sur la source actuelle de la vidéo sans qu’il soit nécessaire de traduire la surface primaire.

RemarqueDxgkDdiSetDisplayPrivateDriverFormat n’applique pas le format de pilote privé que le membre PrivateDriverFormatAttribute de la structure DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT pointée par pSetDisplayPrivateDriverFormat spécifie à toute allocation. DxgkDdiSetDisplayPrivateDriverFormat applique le format du pilote privé directement à la source vidéo présente. Par exemple, DxgkDdiSetDisplayPrivateDriverFormat peut reprogrammer les registres DAC pour les analyser à partir d’un autre format de balayage.
 
DxgkDdiSetDisplayPrivateDriverFormat doit être rendu paginable.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dkmddi.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT

pfnSetDisplayPrivateDriverFormatCb