KsReferenceBusObject 함수(ks.h)

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

통사론

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

매개 변수

[in] Header

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

반환 값

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

발언

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

요구 사항

요구	값
대상 플랫폼	보편적
헤더	ks.h(Ks.h 포함)
라이브러리	Ks.lib