DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT fonction de rappel (dispmprt.h)

Article
02/26/2024

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 d’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 d’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 de 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 retournée

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	La fonction a correctement configuré l’objet de sortie protégé.
STATUS_NO_MEMORY	DxgkDdiOPMConfigureProtectedOutput ne peut pas allouer la mémoire nécessaire pour qu’il se termine.

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.