KsReferenceBusObject 함수(ks.h)

버스 물리적 디바이스 개체를 참조합니다.

구문

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

매개 변수

[in] Header

PnP 디바이스 스택 개체를 포함하는 KsAllocateDeviceHeader 에서 이전에 할당한 헤더를 가리킵니다.

반환 값

참조가 성공하면 STATUS_SUCCESS 반환하고, 그렇지 않으면 STATUS_INSUFFICIENT_RESOURCES 같은 오류를 반환합니다.

설명

이 함수는 디바이스 헤더를 사용하여 PnP 개체 스택을 추적하는 필터에서 사용됩니다. 이 디바이스의 버스에 이러한 참조(예: 소프트웨어 디바이스)가 필요하고 해당 필터 instance 닫을 때 KsDereferenceBusObject에 대한 호출과 일치하면 일반적으로 필터 열기에서 호출됩니다. 호출자는 PnP 디바이스 스택 개체를 설정하기 위해 이전에 KsSetDevicePnpAndBaseObject라고도 해야 합니다. 이 작업은 PnP AddDevice 함수에서 수행되었을 것입니다. 개체가 이전에 참조되지 않은 경우 인터페이스 공간이 할당되고 함수는 PnP 디바이스 개체를 사용하여 버스 참조 인터페이스를 획득합니다. 그런 다음 해당 인터페이스에서 ReferenceDeviceObject 메서드를 호출합니다. 디바이스 헤더가 해제되면 인터페이스 자체가 해제되고 해제됩니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	ks.h(Ks.h 포함)
라이브러리	Ks.lib