DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT fonction de rappel (dispmprt.h)

Article
02/06/2025

La fonction DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT configure l’objet de sortie protégé donné.

Syntaxe

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT DxgkddiOpmConfigureProtectedOutput;

NTSTATUS DxgkddiOpmConfigureProtectedOutput(
  [in] PVOID MiniportDeviceContext,
  [in] HANDLE ProtectedOutputHandle,
  [in] const DXGKMDT_OPM_CONFIGURE_PARAMETERS *Parameters,
  [in] ULONG AdditionalParametersSize,
  [in] const VOID *AdditionalParameters
)
{...}

Paramètres

[in] MiniportDeviceContext

Handle vers un bloc de contexte associé à un adaptateur d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique DirectX.

[in] ProtectedOutputHandle

Handle vers un objet de sortie protégé. La fonction DxgkDdiOPMCreateProtectedOutput crée l’objet de sortie protégé et retourne le handle à l’objet.

[in] Parameters

Pointeur vers une structure DXGKMDT_OPM_CONFIGURE_PARAMETERS qui contient des paramètres utilisés pour configurer l’objet de sortie protégé dont le handle est spécifié dans le paramètre ProtectedOutputHandle.

[in] AdditionalParametersSize

Taille, en octets, des paramètres supplémentaires dans la mémoire tampon pointées par AdditionalParameters. Pour l’émulation COPP (Certified Output Protection Protocol), il s’agit de 0.

[in] AdditionalParameters

Pointeur vers une mémoire tampon qui contient les paramètres supplémentaires utilisés pour configurer l’objet de sortie protégé dont le handle est spécifié dans le paramètre ProtectedOutputHandle. Pour l’émulation COPP, il s’agit de NULL. Si le paramètre AdditionalParametersSize a la valeur 0, AdditionalParameters est toujours défini sur NULL.

Valeur de retour

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT retourne l’une des valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	La fonction a correctement configuré l’objet de sortie protégé.
STATUS_NO_MEMORY	DxgkDdiOPMConfigureProtectedOutput ne peut pas allouer de mémoire nécessaire pour qu’elle soit terminée.

Cette fonction peut également retourner d’autres codes d’erreur définis dans Ntstatus.h.

Remarques

Le sous-système du noyau graphique DirectX appelle DxgkDdiOPMGetInformation ou DxgkDdiOPMGetCOPPCompatibleInformation pour récupérer des informations sur la sortie, puis appelle DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT une ou plusieurs fois pour configurer la sortie.

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT doit être rendu paginable.