DXGKDDI_OPM_GET_CERTIFICATE funzione di callback (dispmprt.h)

Articolo
04/03/2024

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 di 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 tipizzato DXGKMDT_CERTIFICATE_TYPE 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 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 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 di visualizzazione ha rilevato manomissioni.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Il driver miniport di visualizzazione non supporta COPP né perché il fornitore dell'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 di visualizzazione ha rilevato manomissioni.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	Il driver miniport di visualizzazione non supporta uAB perché il fornitore dell'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 di visualizzazione ha rilevato manomissioni.
STATUS_GRAPHICS_PVP_HFS_FAILED	L'analisi delle funzionalità hardware del driver miniport di visualizzazione (HFS) 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 la manomissione, può invece restituire uno dei codici di errore precedenti.

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

Commenti

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 Protezione contenuto di output e Windows Vista .

DxgkDdiOPMGetCertificate deve essere reso pageable.