PFND3DDDI_CREATEAUTHENTICATEDCHANNEL funzione di callback (d3dumddi.h)

  • Articolo

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)

Vedi anche

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL