DXGKDDI_OPM_GET_CERTIFICATE_SIZE funzione di callback (dispmprt.h)

Articolo
04/03/2024

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 a un blocco di contesto associato a una scheda di visualizzazione. In precedenza, la funzione DxgkDdiAddDevice del driver del miniport visualizzato ha fornito questo handle al sottosistema del kernel grafico DirectX.

[in] CertificateType

Valore DXGKMDT_CERTIFICATE_TYPE tipizzato 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 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 manomissione.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Il driver miniport visualizzato non supporta COPP perché il fornitore 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 visualizzato non supporta l'interfaccia utente 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 manomissione.
STATUS_GRAPHICS_PVP_HFS_FAILED	L'analisi hardware del driver miniport visualizzato non è riuscita o il driver miniport visualizzato ha rilevato manomissione. Un driver miniport visualizzato può restituire facoltativamente questo valore. Se DxgkDdiOPMGetCertificateSize non restituisce questo valore per la manomissione, può restituire invece uno dei codici di errore precedenti.

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

Commenti

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

DxgkDdiOPMGetCertificateSize deve essere reso paginabile.

Requisiti

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)

Vedi anche

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice

Condividi tramite