DXGKDDI_OPM_GET_CERTIFICATE funzione di callback (dispmprt.h)

Articolo
02/06/2025

La funzione DxgkDdiOPMGetCertificate recupera un certificato con il tipo e le dimensioni specificati.

Sintassi

DXGKDDI_OPM_GET_CERTIFICATE DxgkddiOpmGetCertificate;

NTSTATUS DxgkddiOpmGetCertificate(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [in]  ULONG CertificateSize,
  [out] PVOID CertificateBuffer
)
{...}

Parametri

[in] MiniportDeviceContext

Handle per un blocco di contesto associato a una scheda di visualizzazione. In precedenza, la funzione dxgkDdiAddDevice del driver miniport di visualizzazione forniva questo handle al sottosistema del kernel grafico DirectX.

[in] CertificateType

Valore DXGKMDT_CERTIFICATE_TYPEtipizzato che identifica il tipo di certificato da recuperare.

[in] CertificateSize

Dimensione, in byte, del certificato da recuperare. Questa dimensione è stata restituita da una chiamata alla funzione dxgkDdiOPMGetCertificateSize del driver di miniport.

[out] CertificateBuffer

Puntatore a un buffer che riceve il certificato richiesto se DxgkDdiOPMGetCertificate restituisce correttamente. Se dxgkDdiOPMGetCertificate ha esito negativo, il contenuto del buffer rimane invariato.

Valore restituito

DxgkDdiOPMGetCertificate restituisce uno dei valori seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha recuperato correttamente le dimensioni del certificato.
STATUS_GRAPHICS_OPM_NOT_SUPPORTED	Il driver di miniport di visualizzazione non supporta OPM perché il fornitore dell'hardware non ha mai firmato il contratto di licenza OPM o l'hardware grafico del driver miniport non è conforme alle regole OPM. DxgkDdiOPMGetCertificate può restituire questo valore anche se il driver miniport visualizzato ha rilevato manomissioni.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Il driver miniport di visualizzazione non supporta COPP né perché il fornitore di hardware non ha mai firmato il contratto di licenza COPP o l'hardware grafico del driver miniport non è conforme alle regole COPP. DxgkDdiOPMGetCertificate può restituire questo valore anche se il driver miniport visualizzato ha rilevato manomissioni.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	Il driver miniport di visualizzazione non supporta uAB perché il fornitore hardware non ha mai firmato il contratto di licenza UAB o l'hardware grafico del driver miniport non è conforme alle regole UAB. DxgkDdiOPMGetCertificate può restituire questo valore anche se il driver miniport visualizzato ha rilevato manomissioni.
STATUS_GRAPHICS_PVP_HFS_FAILED	L'analisi delle funzionalità hardware del driver miniport di visualizzazione non è riuscita o il driver miniport visualizzato ha rilevato manomissioni. Un driver miniport di visualizzazione può facoltativamente restituire questo valore. Se DxgkDdiOPMGetCertificate non restituisce questo valore per manomissione, può invece restituire uno dei codici di errore precedenti.

Questa funzione potrebbe restituire anche altri codici di errore definiti in Ntstatus.h.

Osservazioni

dxgkDdiOPMGetCertificate può recuperare il certificato OPM del driver miniport visualizzato, il certificato UAB (User Accessible Bus) o il certificato COPP (Certified Output Protection Protocol). Per informazioni su questi certificati, scaricare il documento Output Content Protection e Windows Vista.

il DxgkDdiOPMGetCertificate deve essere reso pageable.