PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL funzione di callback (d3d10umddi.h)
Elabora una richiesta da un'applicazione per configurare un canale autenticato per la protezione del contenuto. Implementato da un driver di visualizzazione Windows Display Driver Model (WDDM) 1.2 o versione successiva.
Sintassi
PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Pfnd3d111DdiConfigureauthenticatedchannel;
HRESULT Pfnd3d111DdiConfigureauthenticatedchannel(
D3D10DDI_HDEVICE hDevice,
D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
UINT InputDataSize,
const VOID *pInputData,
D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT *pOutputData
)
{...}
Parametri
hDevice
Handle per il dispositivo di visualizzazione (contesto grafico).
hCAuthChannel
Handle per l'oggetto canale autenticato creato tramite una chiamata alla funzione CreateAuthenticatedChannel(D3D11_1).
InputDataSize
Dimensioni, in byte, della matrice specificata dal parametro pInputData .
pInputData
Puntatore a una matrice di byte che contiene dati di input per il comando. Per altre informazioni, vedere la sezione Osservazioni.
pOutputData
Puntatore a una struttura D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT . Per altre informazioni, vedere la sezione Osservazioni.
Valore restituito
Restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| S_OK | Il canale autenticato è stato configurato correttamente. |
| E_FAIL | Il driver miniport visualizzato non supporta il comando specificato |
| E_INVALIDARG | I parametri sono stati convalidati e determinati per essere non corretti. |
| E_OUTOFMEMORY | Memoria non disponibile per completare l'operazione. |
Commenti
La matrice di byte a cui fa riferimento il parametro pInputData viene formattata nel modo seguente:
Questa matrice inizia con una struttura D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT .
I dati che seguono questa struttura sono in un formato specificato dal membro ConfigureType della struttura.
L'elenco seguente descrive il formato di questi dati in base al membro ConfigureType .
D3D11_1DDI_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION_GUID D3D11_1DDI_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION
D3D11_1DDI_AUTHENTICATED_CONFIGURE_ENCRYPTION_WHEN_ACCESSIBLE_GUID D3D11_1DDI_AUTHENTICATED_CONFIGURE_ACCESSIBLE_ENCRYPTION
D3D11_1DDI_AUTHENTICATED_CONFIGURE_INITIALIZE_GUID D3D11_1DDI_AUTHENTICATED_CONFIGURE_INITIALIZE
D3D11_1DDI_AUTHENTICATED_CONFIGURE_PROTECTION_GUID D3D11_1DDI_AUTHENTICATED_CONFIGURE_PROTECTION
D3D11_1DDI_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE_GUID D3D11_1DDI_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE
La struttura D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT contiene un codice di autenticazione del messaggio CBC basato su AES (OMAC) basato su AES. Il driver miniport di visualizzazione deve calcolare il proprio OMAC sui dati per autenticare i dati. Questa struttura di input contiene anche un handle driver per il canale autenticato, un numero di sequenza e un GUID che indica il tipo di configurazione.
Il driver miniport visualizzato segue questi passaggi quando inizializza la struttura di D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT :
Il driver deve copiare i dati di input nella struttura D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT .
Il driver deve impostare il membro ReturnCode sullo stesso codice restituito restituito per la chiamata ConfigureAuthenticatedChannel(D3D11_1). Ciò fornisce all'applicazione un meccanismo sicuro di accesso al codice restituito.
Il driver imposta il membro omac su zero e quindi calcola un OMAC per i dati nella struttura. Il driver imposta quindi il membro omac su OMAC calcolato
Il driver miniport visualizzato deve restituire E_INVALIDARG per la chiamata ConfigureAuthenticatedChannel in base alle condizioni seguenti:
Il membro omac della strutturaD3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT non corrisponde all'OMAC calcolato dal driver.
Il numero di sequenza non è maggiore di un numero di sequenza specificato in una chiamata di configurazione precedente.
Il numero di sequenza non è ancora stato inizializzato da una chiamata alla funzione ConfigureAuthenticatedChannel(D3D11_1).
Il parametro InputDataSize è minore delle dimensioni della struttura D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT più le dimensioni della struttura specificata dal D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT . ConfigureTypemember.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 |
| Server minimo supportato | Windows Server 2012 |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3d10umddi.h (include D3d10umddi.h) |
Vedi anche
CreateAuthenticatedChannel(D3D11_1)