PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL funzione di callback (d3d10umddi.h)

Articolo
03/08/2023

Crea un oggetto canale autenticato. Implementato da un driver di visualizzazione Windows Display Driver Model (WDDM) 1.2 o versione successiva.

Sintassi

PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;

HRESULT Pfnd3d111DdiCreateauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL *pCreateData,
  D3D11_1DDI_HAUTHCHANNEL hAuthChannel,
  D3D11_1DDI_HRTAUTHCHANNEL hRTAuthChannel
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

pCreateData

Puntatore a una struttura D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL . Questa struttura specifica gli attributi del canale autenticato da creare.

hAuthChannel

Handle per i dati privati del driver per l'oggetto canale autenticato. Per altre informazioni, vedere la sezione Osservazioni.

hRTAuthChannel

Handle per l'oggetto canale autenticato che il driver deve usare quando esegue la chiamata al runtime Direct3D.

Valore restituito

Restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	Il canale autenticato è stato creato correttamente.
D3DDDIERR_DEVICEREMOVED	La scheda grafica è stata rimossa.
E_OUTOFMEMORY	Memoria non disponibile per completare l'operazione.

Commenti

Il runtime Direct3D chiama CreateAuthenticatedChannel(D3D11_1) dopo aver chiamato CalcPrivateAuthenticatedChannelSize del driver per determinare le dimensioni in byte per i dati privati necessari per l'oggetto canale autenticato. Il runtime alloca la memoria per questi dati privati per il driver. Il driver usa questa memoria per archiviare i dati privati correlati all'oggetto canale di autenticazione.

Quando il runtime chiama CreateAuthenticatedChannel(D3D11_1), passa l'handle alla memoria dei dati privati nel parametro hAuthChannel . Questo handle è effettivamente un puntatore alla memoria.

Il driver deve tenere traccia dell'handle per il dispositivo di visualizzazione usato per creare il canale autenticato. Il driver deve non riuscire tutte le chiamate successive che usano questo canale autenticato creato, ad esempio NegotiateAuthenticatedChannelKeyExchange, se il dispositivo di visualizzazione specificato in tali chiamate è diverso dal dispositivo visualizzato usato per creare il canale autenticato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Desktop
Intestazione	d3d10umddi.h (include D3d10umddi.h)

Vedi anche

CalcPrivateAuthenticatedChannelSize

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL

NegotiateAuthenticatedChannelKeyExchange

Condividi tramite