PFND3DDDI_QUERYAUTHENTICATEDCHANNEL funzione di callback (d3dumddi.h)

La funzione QueryAuthenticatedChannel esegue una query su un canale autenticato per informazioni sulle funzionalità e sullo stato.

Sintassi

PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;

HRESULT Pfnd3dddiQueryauthenticatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDIARG_QUERYAUTHENTICATEDCHANNEL che descrive le informazioni sul canale autenticate per la query. Questa struttura contiene un buffer di input che descrive la query e un buffer di output per restituire le informazioni sottoposte a query.

Valore restituito

QueryAuthenticatedChannel restituisce uno dei valori seguenti:

Commenti

Il buffer di input contiene l'handle del driver per il canale autenticato, un numero di sequenza e un GUID che indica il tipo di query. Il driver deve eseguire tutte le query se il driver non ha inizializzato in precedenza il numero di sequenza tramite una chiamata alla relativa funzione ConfigureAuthenticatedChannel . Il driver deve anche non riuscire la query se il numero di sequenza non è maggiore del numero di sequenza della chiamata di query precedente.

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.

QueryAuthenticatedChannel 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 e output non corrispondono alle dimensioni definite per il GUID specificato.

Requisiti

Vedi anche

ConfigureAuthenticatedChannel

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL