Condividi tramite

PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL funzione di callback (d3d10umddi.h)

  • Articolo

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:

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 :

  1. Il driver deve copiare i dati di input nella struttura D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT .

  2. 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.

  3. 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)

D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT

D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT