PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL funzione di callback (d3dumddi.h)

  • Articolo

La funzione ConfigureAuthenticatedChannel imposta lo stato all'interno di un canale autenticato.

Sintassi

PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;

HRESULT Pfnd3dddiConfigureauthenicatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL che descrive come configurare un canale autenticato. Questa struttura contiene un buffer di input che descrive come configurare il canale autenticato e un buffer di output con informazioni di configurazione.

Valore restituito

ConfigureAuthenticatedChannel restituisce uno dei valori seguenti:

Codice restituito Descrizione
S_OK Il canale autenticato è configurato correttamente.
E_OUTOFMEMORY ConfigureAuthenticatedChannel non è riuscito ad allocare la memoria necessaria per il completamento.

Commenti

Il buffer di input contiene un codice di autenticazione dei messaggi in modalità CBC (Cipher Block Chaining) a chiave singola che il driver deve autenticare. Il buffer di input contiene anche l'handle del driver per il canale autenticato, un numero di sequenza e un GUID che indica il tipo di configurazione.

Il driver deve non riuscire ConfigureAuthenticatedChannel se l'input OMAC non corrisponde, se il numero di sequenza non è maggiore di un numero di sequenza specificato in una chiamata precedente o se il numero di sequenza non è ancora stato inizializzato (l'eccezione a questa ultima regola è relativa alla chiamata di inizializzazione stessa).

Il driver deve duplicare i dati di input nella struttura del buffer di output e deve firmare la struttura di output in modo identico a come gestisce attualmente le query di Output Protection Manager (OPM).

Ad eccezione di quelle situazioni in cui l'applicazione specifica erroneamente un buffer di output troppo piccolo, il driver deve sempre inserire il codice restituito nella struttura di output. Di conseguenza, l'applicazione dispone di un meccanismo sicuro per determinare il codice restituito.

ConfigureAuthenticatedChannel esegue operazioni diverse a seconda di ognuno dei GUID seguenti specificati nella struttura di input. Il driver deve avere esito negativo se le dimensioni del buffer di input non corrispondono alle dimensioni definite per il GUID specificato.

Requisiti

Requisito Valore
Client minimo supportato ConfigureAuthenticatedChannel è supportato a partire dal sistema operativo Windows 7.
Piattaforma di destinazione Desktop
Intestazione d3dumddi.h (include D3dumddi.h)

Vedi anche

D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL