PFND3DDDI_CREATEAUTHENTICATEDCHANNEL funzione di callback (d3dumddi.h)
La funzione CreateAuthenticatedChannel crea un canale che il runtime di Microsoft Direct3D e il driver può usare per impostare e 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 . In input, questa struttura contiene informazioni che il driver può usare. Nell'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 è riuscito a 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. |
Commenti
Il runtime passa l'handle al canale autenticato restituito dal driver nel membro ChannelType 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 AuthenticationdChannelKeyExchange ) se il dispositivo visualizzato specificato in tali chiamate è diverso dal dispositivo visualizzato usato per creare il canale autenticato.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | CreateAuthenticatedChannel è supportato a partire dal sistema operativo Windows 7. |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dumddi.h (include D3dumddi.h) |