IDXGIAdapter3::RegisterHardwareContentProtectionTeardownStatusEvent method

Registers to receive notification of hardware content protection teardown events.

Syntax

HRESULT RegisterHardwareContentProtectionTeardownStatusEvent(
  [in]  HANDLE hEvent,
  [out] DWORD  *pdwCookie
);

Parameters

hEvent [in]

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.

pdwCookie [out]

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

See also

IDXGIAdapter3