Функция WdfObjectDereferenceActual (wdfobject.h)

[Применимо к KMDF и UMDF]

Метод WdfObjectDereferenceActual уменьшает количество ссылок для указанного объекта платформы и назначает значение тега, номер строки и имя файла ссылке.

Синтаксис

VOID WdfObjectDereferenceActual(
  [in]           WDFOBJECT Handle,
  [in, optional] PVOID     Tag,
  [in]           LONG      Line,
  [in, optional] PCCH      File
);

Параметры

[in] Handle

Дескриптор объекта платформы.

[in, optional] Tag

Определяемое драйвером значение, определяющее ссылку на объект. Значение тега должно соответствовать значению тега, которое драйвер ранее предоставил WdfObjectReferenceActual.

[in] Line

Числовое значение, представляющее номер строки в исходном файле драйвера.

[in, optional] File

Указатель на строку констант, завершающую значение NULL, которая представляет имя исходного файла драйвера. Этот параметр является необязательным и может быть null.

Возвращаемое значение

Нет

Замечания

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Если число ссылок объекта становится нулевым, объект может быть удален до возврата WdfObjectDereferenceActual.

Вызов WdfObjectDereferenceActual или WdfObjectDereferenceWithTag вместо WdfObjectDereference предоставляет дополнительную информацию (строку тега, номер строки и имя файла) в отладчики Майкрософт. WdfObjectDereferenceActual позволяет драйверу указать номер строки и имя файла, а WdfObjectDereferenceWithTag использует текущий номер строки и имя файла драйвера.

Вы можете просмотреть значения тегов, номеров строк и имени файла с помощью расширения отладчика !wdftagtracker. Расширение отладчика отображает значение тега как указатель, так и ряд символов. Дополнительные сведения о расширениях отладчика см. в разделе Отладка драйвера KMDF.

Дополнительные сведения о количествах ссылок на объекты и правилах очистки для иерархии объектов платформы см. в жизненного цикла объектов Framework.

Примеры

Следующий пример кода уменьшает количество ссылок объекта и назначает значение тега, номер строки и имя файла ссылке.

WdfObjectDereferenceActual(
                           object,
                           pTag,
                           line,
                           FILE_NAME
                           );

Требования

См. также

WdfObjectDereference

WdfObjectReferenceActual