DXGKDDI_OPM_GET_CERTIFICATE_SIZE funzione di callback (dispmprt.h)

Articolo
02/06/2025

La funzione DxgkDdiOPMGetCertificateSize recupera le dimensioni di un certificato del tipo specificato.

Sintassi

DXGKDDI_OPM_GET_CERTIFICATE_SIZE DxgkddiOpmGetCertificateSize;

NTSTATUS DxgkddiOpmGetCertificateSize(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [out] PULONG CertificateSize
)
{...}

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 DXGKMDT_CERTIFICATE_TYPE-typed che identifica il tipo di certificato le cui dimensioni DxgkDdiOPMGetCertificateSize restituisce.

[out] CertificateSize

Puntatore a una variabile che riceve le dimensioni, in byte, del certificato il cui tipo è identificato dal valore nel parametro CertificateType.

Valore restituito

DxgkDdiOPMGetCertificateSize 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. DxgkDdiOPMGetCertificateSize 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. DxgkDdiOPMGetCertificateSize può restituire questo valore anche se il driver miniport ha rilevato manomissione.
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. DxgkDdiOPMGetCertificateSize 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 DxgkDdiOPMGetCertificateSize 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

dxgkDdiOPMGetCertificateSize può recuperare le dimensioni del 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 DxgkDdiOPMGetCertificateSize deve essere reso pageable.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Desktop
intestazione	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL (vedere la sezione Osservazioni)

Vedere anche

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice

Condividi tramite