IDXGIAdapter3::RegisterHardwareContentProtectionTeardownStatusEvent method (dxgi1_4.h)
Registers to receive notification of hardware content protection teardown events.
Syntax
HRESULT RegisterHardwareContentProtectionTeardownStatusEvent(
[in] HANDLE hEvent,
[out] DWORD *pdwCookie
);
Parameters
[in] hEvent
Type: HANDLE
A handle to the event object that the operating system sets when hardware content protection teardown occurs. The CreateEvent or OpenEvent function returns this handle.
[out] pdwCookie
Type: DWORD*
A pointer to a key value that an application can pass to the IDXGIAdapter3::UnregisterHardwareContentProtectionTeardownStatus method to unregister the notification event that hEvent specifies.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
Call ID3D11VideoDevice::GetContentProtectionCaps() to check for the presence of the D3D11_CONTENT_PROTECTION_CAPS_HARDWARE_TEARDOWN capability to know whether the hardware contains an automatic teardown mechanism.
After the event is signaled, the application can call ID3D11VideoContext1::CheckCryptoSessionStatus to determine the impact of the hardware teardown for a specific ID3D11CryptoSession interface.
Requirements
Requirement | Value |
---|---|
Target Platform | Windows |
Header | dxgi1_4.h (include DXGI1_3.h) |
Library | Dxgi.lib |
DLL | Dxgi.dll |