DXGKDDI_OPM_GET_CERTIFICATE_SIZE funzione di callback (dispmprt.h)
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) |