PFND3DDDI_CREATECRYPTOSESSION回呼函式 (d3dumddi.h)
CreateCryptoSession 函式會建立密碼編譯會話,Direct3D 運行時間會用來管理會話密鑰,以及執行加密作業到受保護的記憶體和外。
語法
PFND3DDDI_CREATECRYPTOSESSION Pfnd3dddiCreatecryptosession;
HRESULT Pfnd3dddiCreatecryptosession(
HANDLE hDevice,
D3DDDIARG_CREATECRYPTOSESSION *unnamedParam2
)
{...}
參數
hDevice
顯示裝置的句柄 (圖形內容) 。
unnamedParam2
pData [in, out]
D3DDDIARG_CREATECRYPTOSESSION 結構的指標。 在輸入時,此結構包含驅動程式可以使用的資訊。 在輸出時,驅動程式會指定 Microsoft Direct3D 運行時間可以使用之結構中的資訊。
傳回值
CreateCryptoSession 會傳回下列其中一個值:
傳回碼 | 描述 |
---|---|
S_OK | 已成功建立密碼編譯會話。 |
E_OUTOFMEMORY | CreateCryptoSession 無法配置所需的記憶體,使其完成。 |
D3DDDIERR_NOTAVAILABLE | 驅動程式不支援 在 D3DDDIARG_CREATECRYPTOSESSION 結構的 CryptoTypemember 中指定的 GUID,或NULL_GUID (在 CryptoTypemember 中指定所有零) 。 |
D3DDDIERR_UNSUPPORTEDCRYPTO | 驅動程式不支援指定譯碼類型的密碼編譯類型。 |
備註
如果D3DDDIARG_CREATECRYPTOSESSION結構的 DecodeProfile 成員NULL_GUID,則加密會話將不會用於 DirectX 視訊加速 (DirectX VA) 譯碼。 如果 DecodeProfile 不是 NULL GUID,則如果譯碼配置檔不支援 CryptoType 成員中的密碼編譯 類型,驅動程式應該會失敗並D3DDDIERR_UNSUPPORTEDCRYPTO。
驅動程式會傳回 D3DDDIARG_CREATECRYPTOSESSION hCryptoSession 成員中密碼編譯會話的句柄,運行 時間 會傳入所有後續密碼編譯會話呼叫 (,例如 CryptoSessionKeyExchange) 。
驅動程式必須追蹤用來建立密碼編譯會話的顯示裝置 (hDevice) 。 如果這些呼叫中指定的顯示裝置與用來建立密碼編譯會話的顯示裝置不同,驅動程式應該會失敗所有使用此已建立密碼編譯會話的後續呼叫。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 7 開始支援。 |
目標平台 | 桌面 |
標頭 | d3dumddi.h (包含 D3dumddi.h) |