PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL funzione di callback (d3d10umddi.h)
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)