PFND3DDDI_QUERYAUTHENTICATEDCHANNEL funzione di callback (d3dumddi.h)

  • Articolo

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:

Codice restituito Descrizione
S_OK Viene eseguita una query sul canale autenticato.
E_OUTOFMEMORY QueryAuthenticatedChannel non è riuscito ad allocare la memoria necessaria per il completamento.

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

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

Vedi anche

ConfigureAuthenticatedChannel

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL