Edit

IDXGIAdapter3::RegisterHardwareContentProtectionTeardownStatusEvent method (dxgi1_4.h)

  • Article

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

See also

IDXGIAdapter3