PFND3DDDI_CREATEAUTHENTICATEDCHANNEL funzione di callback (d3dumddi.h)
La funzione CreateAuthenticatedChannel crea un canale che il runtime di Microsoft Direct3D e il driver possono usare per impostare ed eseguire query di protezione.
Sintassi
PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;
HRESULT Pfnd3dddiCreateauthenticatedchannel(
HANDLE hDevice,
D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
Parametri
hDevice
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
pData [in, out]
Puntatore a una struttura D3DDDIARG_CREATEAUTHENTICATEDCHANNEL. All'input, questa struttura contiene informazioni che il driver può usare. In caso di output, il driver specifica le informazioni nella struttura che il runtime Direct3D può usare.
Valore restituito
CreateAuthenticatedChannel restituisce uno dei valori seguenti:
| codice restituito | Descrizione |
|---|---|
| S_OK | Il canale viene creato correttamente. |
| E_OUTOFMEMORY | createAuthenticatedChannel non è stato possibile allocare la memoria necessaria per il completamento. |
| D3DDDIERR_NOTAVAILABLE | Il driver non supporta il tipo di canale specificato nel membro ChannelType della struttura D3DDDIARG_CREATEAUTHENTICATEDCHANNEL a cui punta il parametro pData. |
Osservazioni
Il runtime passa l'handle al canale autenticato restituito dal driver nel ChannelType membro della struttura D3DDDIARG_CREATEAUTHENTICATEDCHANNEL in tutte le chiamate successive che richiedono l'handle.
Il driver deve tenere traccia del dispositivo di visualizzazione (hDevice) usato per creare il canale autenticato. Il driver deve non riuscire tutte le chiamate successive che usano questo canale autenticato creato(ad esempio, la funzione AuthenticatedChannelKeyExchange) se il dispositivo di visualizzazione specificato in tali chiamate è diverso dal dispositivo di visualizzazione usato per creare il canale autenticato.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | CreateAuthenticatedChannel è supportato a partire dal sistema operativo Windows 7. |
| piattaforma di destinazione | Desktop |
| intestazione | d3dumddi.h (include D3dumddi.h) |